使用说明

MCP服务器示例

目前只能在ChatGPT Pro或更高版本的开发人员模式下工作。

看 MCP im-ChatGPT开发者模式（测试版）了解如何在ChatGPT Pro或更高版本中设置连接器。

# uv sync
uv run python -m sample_mcp_server
# source .venv/bin/activate
# python -m sample_mcp_server
# uv build

或与 uvx:

uvx --from git+https://github.com/cs224/sample-mcp-server.git python -m sample_mcp_server

在另一个终端中，运行吸烟:

ngrok http 8000

ngrok将向您显示一个公共URL，例如：

https://abc123.ngrok-free.app → http://localhost:8000

适用于FastMCP transport="http"，MCP端点通常位于 /mcp. “使用 /mcp 如果您使用http传输部署MCP，请在URL末尾添加，以及 /sse 如果你使用sse。"

所以你的 ChatGPT的MCP服务器URL 将：

https://abc123.ngrok-free.app/mcp

作为专业用户：

启用开发者模式
- 设置→ 连接器 → 高级/开发人员模式→ 打开。
添加连接器
- 在 连接器 选项卡，单击创建（或类似）。
- 姓名： Sample MCP Server
- 描述：“返回我最喜欢的乐队的玩具MCP服务器”
- 服务器URL: https://abc123.ngrok-free.app/mcp
- 认证：选择“无认证”（适用于此玩具；不适用于生产）。
如果服务器可以访问并且响应正确，ChatGPT应该向您显示它发现的工具(get_favorite_bands, search, fetch).
在聊天中使用它
- 打开A 新聊天 （开发者模式横幅位于顶部）。
- 在工具/“已连接的应用程序”菜单中，启用 Sample MCP Server 该聊天的连接器。
- 现在，模型可以调用这些工具。

如果你想确切地看到工具何时被调用，请保持终端和MCP服务器可见——我们添加的日志将显示每次调用。

在正常的开发人员模式聊天中启用连接器后：

直接调用工具（最喜欢的乐队）

“使用 MCP服务器示例 连接器，调用 get_favorite_bands 工具，并准确地告诉我它返回了什么。"

您应该看到您的日志：
```
INFO:sample_mcp_server.server:get_favorite_bands tool called with question=...
```
ChatGPT将回复如下：

我最喜欢的乐队是：Mgła、Revocation、Whitechapel。
搜索+引用

“使用 MCP服务器示例 连接器 search 该工具用于查找我听过的乐队，然后用引文总结结果。"

这应该触发：
```
INFO:sample_mcp_server.server:search tool called with query=...
```
ChatGPT应该显示一个摘要以及由伪造文件支持的引用 results 条目。
按ID提取

“使用 MCP服务器示例 连接器，首先搜索频段，然后呼叫 fetch 使用其中一个结果ID的工具。显示原始JSON fetch."

在日志中，您将看到：
```
search tool called with query=...
fetch tool called with id='100'
```
深入研究（可选）
- 开始深度研究运行并添加 Sample MCP Server 作为一个来源。
- 提示：
  
  “仅使用示例MCP服务器连接器作为来源，告诉我我最喜欢的乐队是什么，并引用相关文档。”
深度研究应致电 search （可能 fetch)然后给出一个完整引用的答案。