MCP Chat

MCP Chat 是一个命令行界面应用程序，可通过 Anthropic API 与 AI 模型进行交互式聊天。该应用程序通过 MCP (Model Control Protocol) 架构支持文档检索、基于命令的提示以及可扩展的工具集成。

前提条件

• Python 3.9+

• Anthropic API Key

Related MCP server: MCP Chat Server

设置

步骤 1：配置环境变量

1. 在项目根目录中创建或编辑 .env 文件，并确保以下变量已正确设置：

CLAUDE_MODEL="claude-sonnet-4-5"
ANTHROPIC_API_KEY=""  # Enter your Anthropic API secret key

# Set to 1 if you're using uv to run the project
# Set to 0 if you're *not* using uv
USE_UV=1

步骤 2：安装依赖项

选项 1：使用 uv 进行设置（推荐）

uv 是一个快速的 Python 包安装器和解析器。

1. 如果尚未安装，请安装 uv：

pip install uv

2. 创建并激活虚拟环境：

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. 安装依赖项：

uv pip install -e .

4. 运行项目

uv run main.py

选项 2：不使用 uv 进行设置

1. 创建并激活虚拟环境：

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

2. 安装依赖项：

pip install anthropic python-dotenv prompt-toolkit "mcp[cli]==1.8.0"

3. 运行项目

python main.py

使用说明

基本交互

只需输入消息并按 Enter 即可与模型聊天。

文档检索

使用 @ 符号后跟文档 ID，以在查询中包含文档内容：

> Tell me about @deposition.md

命令

使用 / 前缀执行 MCP 服务器中定义的命令：

> /summarize deposition.md

按下 Tab 键时，命令将自动补全。

开发

添加新文档

编辑 mcp_server.py 文件，将新文档添加到 docs 字典中。

实现 MCP 功能

要完整实现 MCP 功能：

1. 完成 mcp_server.py 中的 TODO 项

2. 在 mcp_client.py 中实现缺失的功能

Lint 检查与类型检查

目前未实现任何 lint 或类型检查。