内容
# MCP 聊天
MCP 聊天是一款命令行界面应用程序,通过Anthropic API与 AI 模型启用交互式聊天功能。该应用程序支持文档检索、基于命令的提示以及通过 MCP(模型控制协议)架构的可扩展工具集成。
## 前置条件
- Python 3.9+
- Anthropic API 密钥
## 设置
### 步骤 1:配置环境变量
1. 在项目根目录中创建或编辑 `.env` 文件,并验证以下变量是否正确设置:
```
ANTHROPIC_API_KEY="" # 输入您的 Anthropic API 密钥
```
### 步骤 2:安装依赖项
#### 选项 1:使用 uv 设置(推荐)
[uv](https://github.com/astral-sh/uv) 是一个快速的 Python 包安装程序和解析器。
1. 如果尚未安装 uv,请安装:
```bash
pip install uv
```
2. 创建并激活虚拟环境:
```bash
uv venv
source .venv/bin/activate # 在 Windows 上:.venv\Scripts\activate
```
3. 安装依赖项:
```bash
uv pip install -e .
```
4. 运行项目:
```bash
uv run main.py
```
#### 选项 2:无需 uv 设置
1. 创建并激活虚拟环境:
```bash
python -m venv .venv
source .venv/bin/activate # 在 Windows 上:.venv\Scripts\activate
```
2. 安装依赖项:
```bash
pip install anthropic python-dotenv prompt-toolkit "mcp[cli]==1.8.0"
```
3. 运行项目:
```bash
python main.py
```
## 使用
### 基本交互
只需输入您的消息并按 Enter 键即可与模型聊天。
### 文档检索
使用 @ 符号后跟文档 ID,将文档内容包含在查询中:
```
> 告诉我关于 @deposition.md
```
### 命令
使用 / 前缀执行 MCP 服务器中定义的命令:
```
> /summarize deposition.md
```
当您按 Tab 键时,命令将自动完成。
## 开发
### 添加新文档
编辑 `mcp_server.py` 文件以将新文档添加到 `docs` 字典中。
### 实现 MCP 功能
要完全实现 MCP 功能:
1. 完成 `mcp_server.py` 中的 TODO
2. 在 `mcp_client.py` 中实现缺失的功能
### 代码检查和类型检查
目前没有实现代码检查和类型检查。