MCP Chat

MCP Chat 是一个命令行界面应用程序，支持通过 Anthropic API 与 AI 模型进行交互式聊天。该应用程序支持文档检索、基于命令的提示词，以及通过 MCP（模型控制协议）架构实现的可扩展工具集成。

先决条件

• Python 3.9+

• Anthropic API Key

设置

第 1 步：配置环境变量

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

ANTHROPIC_API_KEY=""  # Enter your Anthropic API secret key

第 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

使用方法

基本交互

只需输入您的消息并按回车键即可与模型聊天。

文档检索

使用 @ 符号后跟文档 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 中实现缺失的功能

代码检查与类型检查

目前尚未实现代码检查或类型检查。