命令行聊天应用

MCP聊天

MCP Chat是一个命令行聊天应用程序，由 OpenAI API它通过MCP（模型上下文协议）架构支持文档检索、基于命令的提示和可扩展的工具集成。

先决条件

• Python 3.10、3.11、3.12或3.13 （3.14尚未得到支持。）
• OpenAI API密钥 (在这里买一个)

设置

步骤1：配置环境

1. 创建一个 .env 项目根目录中的文件。

2. 设置您的OpenAI API密钥以及可选的模型：

OPENAI_API_KEY="sk-..."
OPENAI_MODEL="gpt-4o-mini"

OPENAI_MODEL 默认为 gpt-4o-mini 如果没有设置。

步骤2：安装依赖项

选项1：带紫外线（推荐）

1. 安装 紫外线 如果需要： 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：无紫外线

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

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

2. 安装依赖项：

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

3. 运行：

python main.py

用法

• 聊天： 键入您的信息，然后按Enter键。
• 文件： 使用 @doc_id 包括文档内容（例如。 Tell me about @deposition.md).
• 命令： 使用 /command doc_id （例如。 /summarize deposition.md).选项卡完成可用。

发展

• 在中添加文档 mcp_server.py （例如 docs 字典）。
• 扩展MCP功能 mcp_server.py 和 mcp_client.py.

故障排除

Failed to build pydantic-core /锈蚀错误

使用Python 3.10–3.13（例如。 uv python install 3.12 然后 uv venv --python 3.12 并重新安装）。

API密钥/速率限制无效

• 检查 OPENAI_API_KEY 在 .env.
• 对于费率或配额错误，请在以下位置添加学分 OpenAI计费.