Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Chatsummarize the key points from @project_plan.md"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Chat
MCP Chat is a command-line interface application. The application supports document retrieval, command-based prompts, and extensible tool integrations via the MCP (Model Control Protocol) architecture.
Prerequisites
Python 3.9+
Any Chat Completions LLM API Key and Provider (i.e: Gemini)
Related MCP server: MCP Toolbox
Setup
Step 1: Configure the environment variables
Create or edit the
.envfile in the project root and verify that the following variables are set correctly:
Step 2: Install dependencies
uv is a fast Python package installer and resolver.
Install uv, if not already installed:
Create and activate a virtual environment:
Install dependencies:
Start MCP Server:
Run the project with ChatAgent in CLI
Optionally start inspector
Usage
Basic Interaction
Simply type your message and press Enter to chat with the model.
Document Retrieval
Use the @ symbol followed by a document ID to include document content in your query:
Commands
Use the / prefix to execute commands defined in the MCP server:
Commands will auto-complete when you press Tab.
Development
Adding New Documents
Edit the mcp_server.py file to add new documents to the docs dictionary.
Implementing MCP Features
To fully implement the MCP features:
Complete the TODOs in
mcp_server.pyImplement the missing functionality in
mcp_client.py
Linting and Typing Check
There are no lint or type checks implemented.