MCP Chat

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

前提条件

• Python 3.9+

• Anthropic API 密钥

设置

步骤 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

用法

基本交互

直接输入消息并按 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 检查或类型检查。