software

MCP server 模板报告（使用 Claude）

发布: (2026年1月17日 GMT+8 11:51)
7 min read
原文: Dev.to

I’m happy to translate the article for you, but I’ll need the full text you’d like translated. Could you please paste the content (excluding the source line you already provided) here? Once I have it, I’ll translate it into Simplified Chinese while preserving the formatting, markdown, and any code blocks.

介绍

我最近在 AI 方面玩得很开心，我发现自己经常做的一件事是与 MCP 服务器集成，然后使用 Claude 中的 Projects 功能生成自定义报告。

这是什么？

我已经搭建了一个远程 MCP 服务器，用于从星球大战 API（SWAPI）获取数据。该服务器托管在我的一个域名上。为了让本文简短且聚焦，我将只讨论 Claude 组件，而不涉及 MCP 服务器的具体细节。服务器已经启动并运行，我可以连接到它。

MCP server screenshot

MCP 服务器

MCP 服务器提供两个工具：

  • get_swapi_character – 根据 ID 从 SWAPI 获取角色信息。
  • get_all_swapi_people – 获取 SWAPI 中的所有人物。

MCP tools screenshot

虽然这只是 MCP 服务器中工具的一个非常简单的实现，但它已经能够满足使用 MCP 和可用工具生成报告的需求。

Claude Project

我正在使用 Claude 项目来保持上下文和指令的自包含，这样更容易确保所有模板和历史记录保持在一起。

Claude 项目截图

您可以在此处阅读有关 Claude 项目的介绍：

创建 Claude 项目的一部分是编写 指令。这些指令告诉 Claude 在每次使用项目时该做什么。

项目指令截图

项目指令规定我们应当：

  1. 使用我们的模板文件创建文档。
  2. 为项目指定一个默认名称。
  3. 阅读模板内部的附加指令。
  4. 不要使用默认的《星球大战》品牌风格（黑黄配色会导致图表难以阅读）。
  5. 询问用户是希望输出为 PowerPoint（.ppt）还是 Word 文档（.doc）。

所有这些指令都会在使用项目时执行。最重要的两条是读取模板文件中的指令以及避免使用《星球大战》品牌风格。

模板文件

模板文件是一个标准的 Word 文档，其中 嵌入了额外的指令。它还使用了一个变量来设置项目名称。

Template file screenshot

我在模板中保持了提示相对简单直接，但你完全可以添加更复杂的提示以实现不同的功能。

我尚未尝试在模板内部直接放置显式的工具调用。注意，项目说明中已经包含了一个显式的工具调用。

报告生成

要生成报告，我只需打开 Claude，导航到项目，并说 “generate report.”

Generating report screenshot

有趣的是，尽管让用户选择输出格式的指令是项目中的 最后 条指令，Claude 却 首先 执行它。Claude 知道没有该信息就无法继续，所以会立即提示用户。

在思考过程中，Claude 会读取模板、综合指令，并决定调用哪个工具。当连接了多个 MCP 服务器时，指定连接名称或直接指定工具可以更快且更可靠。

Tool selection screenshot

下一步

我们可以看到正确的工具调用已被使用，数据也已返回。这就是客户端（Claude）发起工具调用并从后端 API 收到响应的地方。

Tool call response

Data processing

重新键入行星数据

接下来的两个步骤很有意思。第一步是从 Claude 查询的现有数据集中提取行星数据。实际上，它是对已有数据进行重新排列或重新键入，因为行星数据嵌套在人物数据中。

Re‑keying planet data

导出 PPTX

最后一步：Claude 使用其内置技能为我导出一个 .pptx 文件，以便检查。

Exported PPTX preview

输出概览

输出很简单：

  • 行星数据的图表。
  • 包含我在模板中请求的字段的人员表格。

最令人惊讶的是，品牌 不是 传统的黑黄配色。

行星数据的图表
人员表格

MCP 日志

在服务器端，我们可以看到客户端（Claude）首先列出了工具，然后调用了 get_all_swapi_people 工具。我将在另一篇文章中进一步深入探讨此事。

2026-01-16 03:09:20 - mcp.server.lowlevel.server - INFO - Processing request of type ListToolsRequest
2026-01-16 03:10:39 - mcp.server.lowlevel.server - INFO - Processing request of type CallToolRequest
2026-01-16 03:10:39 - root - INFO - Tool called: get_all_swapi_people with arguments: {}
2026-01-16 03:10:39 - root - INFO - Fetching all people from SWAPI
2026-01-16 03:10:39 - root - INFO - Making request to: http://localhost:3000/people/
2026-01-16 03:10:39 - httpx - INFO - HTTP Request: GET http://localhost:3000/people/ "HTTP/1.1 200 OK"
2026-01-16 03:10:39 - root - INFO - Successfully fetched data from: http://localhost:3000/people/
2026-01-16 03:10:39 - root - INFO - Successfully fetched 83 people

摘要

如果您没有使用 Claude 和 MCP 来进行自动报告生成（以及更多功能），就错失了很多机会。整个设置过程几乎不费力：

  • 模板大约只用了 5 分钟 就创建完成。
  • 项目说明简明清晰，只需几次小的迭代即可完成。

使用场景非常丰富——生成监管报告、定期业务仪表盘，或任何周期性文档。

我强烈推荐使用 MCP 和 Claude 项目来满足您的报告生成需求。 它们易于上手，且灵活性惊人！

Back to Blog

相关文章

阅读更多 »