MCP Reference Example

MCP聊天参考示例

Claude支持的聊天CLI应用程序，与 模型上下文协议（MCP） 服务器。

描述

模型上下文协议（MCP） 是一个开放标准，允许AI模型以可组合的方式与外部工具、数据源和服务进行交互。您可以定义MCP服务器，而不是硬编码集成，这些服务器公开：

• 工具：Claude可以调用的函数
• 资源：克劳德可以读取的数据
• 提示：可重用提示模板

然后，任何兼容MCP的客户端都可以使用它们。

该项目展示了完整的端到端集成：

• 一 MCP服务器 建于 FastMCP 它管理一组模拟文档，将它们作为工具、资源和提示模板公开。
• 一 MCP客户端 它连接到一个或多个服务器，发现它们的功能，并将它们作为工具公开给Claude。
• A. Claude驱动的聊天CLI 使用代理工具使用循环、document@references和slash命令，所有这些都通过带有标签完成的终端UI驱动。

建筑

+---------+     +-----------+     +------------+
|   CLI   | --> | Chat Loop |  | Claude API |
+---------+     +-----------+     +------------+
                      |
                      v
               +------------+     +------------+
               | MCP Client | --> | MCP Server |
               +------------+     +------------+
                                  tools, resources, prompts

您在中键入消息 命令行界面，它解析@mentions和slash命令，并用文档上下文丰富提示。这 聊天循环 将提示发送到 克劳德，这可能会请求工具调用。这 MCP客户端 将这些呼叫转发给 MCP服务器 并返回结果。重复此循环，直到Claude产生最终响应。

特性

• 代理工具使用循环：Claude自主调用MCP工具（读取/编辑文档），直到它有足够的信息做出响应
• @提及：引用任何内联文档（例如。 compare @report.pdf with @financials.docx)其内容被自动提取并注入到提示中
• 斜杠命令：直接从CLI调用服务器端提示模板(/format, /summarize)
• Tab 补全：斜线命令、文档ID和@提及的自动补全
• 多服务器支持：同时连接多个MCP服务器；克劳德看到他们所有的工具都统一了
• MCP图元：服务器演示了所有三个MCP原语：工具、资源和提示

先决条件

• Python 3.13+
• uv （推荐）或 pip
• 一 无烟煤API键

设置

1. 安装依赖项

使用 uv （推荐）：

   uv sync

或与 pip:

   pip install -e .

1. 配置环境变量

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

   ANTHROPIC_API_KEY=sk-ant-...       # Your Anthropic API key
   CLAUDE_MODEL=claude-sonnet-4-6     # Claude model to use
   USE_UV=1                           # 1 if using uv, 0 if using python

1. 运行应用程序

   uv run main.py
   # or
   python main.py

用法

定期聊天

只需键入您的信息，然后按Enter键。Claude可以访问用于阅读和编辑与服务器捆绑在一起的示例模拟文档的工具。

> What documents are available?
> Read the deposition and give me a brief summary.
> Edit report.pdf to fix the typo in the second paragraph.

@提及

在任何文档ID前添加前缀 @ 自动获取其内容并将其包含在提示中，而无需调用工具。

> What are the key differences between @financials.docx and @outlook.pdf?
> Does @deposition.md contradict anything in @report.pdf?

键入后可以完成选项卡 @.

斜杠命令

Slash命令调用服务器端提示模板。选项卡补全可用于命令和文档ID。

> /summarize report.pdf
> /format spec.txt

连接其他MCP服务器

将其他服务器脚本作为参数传递给 main.py 在内置文档服务器旁边连接它们：

uv run main.py path/to/other_server.py
# or
python main.py path/to/other_server.py

所有服务器的工具都会自动聚合并提供给Claude。

退出

> :q
> :quit

有用的命令

# Run the chat app
uv run main.py
# or
python main.py

# Inspect the MCP server interactively with the MCP developer tools
uv run mcp dev server/mcp_server.py

# Run all tests
pytest

# Run tests with verbose output
pytest -v

项目结构

+---------------------+     +-----------------------------+     +----------------+
| CLI                 | --> | Chat Loop                   |  | Claude API     |
| core/cli.py         |     | core/chat.py                |     | core/claude.py |
| core/cli_chat.py    |     | core/tools.py               |     +----------------+
+---------------------+     +-----------------------------+
                                        |
                                        v
                             +------------------+     +------------------------+
                             | MCP Client       | --> | MCP Server             |
                             | client/          |     | server/mcp_server.py   |
                             | mcp_client.py    |     +------------------------+
                             +------------------+

                             main.py wires all of the above together