MCP Catalogs
Homemcp_chatbot screenshot

mcp_chatbot

by keli-wen·247·Score 46

A Python chatbot implementation compatible with MCP, supporting terminal and Streamlit interfaces with customizable LLM integration.

ai-llmdeveloper-toolsproductivity
53
Forks
10
Open issues
10 mo ago
Last commit
2d ago
Indexed

Overview

MCPChatbot is a comprehensive implementation demonstrating how to integrate the Model Context Protocol with customized LLMs like Qwen. The project provides multiple interfaces including CLI chatbot, terminal chat with streaming responses, and a Streamlit web interface. It includes example scripts for single prompt processing in both regular and streaming modes, along with a custom MCP server for Markdown processing. The codebase is well-structured with clear separation of concerns for chat management, configuration handling, LLM client implementation, and MCP tool integration.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

you:Building chatbot applications with MCP tool integration capabilities
you:Creating interactive terminal interfaces with LLM and MCP tool support
you:Developing web-based chatbots with real-time streaming responses and tool visualization
you:Which LLM providers are supported?
you:How do I add a new MCP server?

When to choose this

Choose this implementation if you're developing chatbots that need to interact with MCP tools, especially if you need multiple interface options (CLI, terminal, web) and want to integrate with custom LLM providers.

When NOT to choose this

Don't choose this if you need a production-ready MCP server implementation rather than a chatbot framework, or if you require advanced authentication and security features.

Tools this server exposes

1 tool extracted from the README (low confidence)
  • markdown_processor

    Processes markdown files through an MCP server

Note: Only one tool (markdown_processor) could be inferred from the MCP server configuration, though its specific functions are not well-documented in the README. The tool appears to be defined in mcp_servers/markdown_processor.py but the README

Comparable tools

mcp-server-templatemcp-websocket-serverlangchain-mcp

Installation

Installation

  1. Clone the repository:
git clone git@github.com:keli-wen/mcp_chatbot.git
cd mcp_chatbot
  1. Set up virtual environment and install dependencies:
pip install uv
uv venv .venv --python=3.10
source .venv/bin/activate  # or .venv\Scripts\activate for Windows
uv pip install -r requirements.txt
  1. Configure environment:
cp .env.example .env
# Edit .env with your API keys and paths
  1. Configure MCP servers in mcp_servers/servers_config.json

For Claude Desktop, add to claude_desktop_config.json:

{
  "mcpServers": {
    "mcp_chatbot": {
      "command": "python",
      "args": ["-m", "mcp_chatbot.server"]
    }
  }
}

FAQ

Which LLM providers are supported?
The implementation supports various LLM providers including Qwen and Ollama. You can configure any LLM API by setting the base_url and api_key in the .env file.
How do I add a new MCP server?
Add your new server implementation in the `mcp_servers/` directory and update the `servers_config.json` file to include your new server configuration with the appropriate command and arguments.

Compare mcp_chatbot with

GitHub →

Last updated · Auto-generated from public README + GitHub signals.