refined-mcp-servers

refined-mcp-servers 是调优的 MCP 服务器。平衡抽象，避免工具过载。

https://github.com/promplate/refined-mcp-servers

实现¶

实现基于 FastMCP 与 pydantic-settings（异步 anyio），并在工具层实现了对外部接口（例如 GitHub GraphQL）的封装：源码 packages/gh/gh_mcp/impl.py 提供了 github_graphql 工具与 DEFAULT_JQ，并使用 ToolAnnotations（含 readOnlyHint）来标记只读工具与查询。整体设计偏向为 LLM 场景优化（工具简洁、可声明副作用、优先只读查询）。

深入洞见¶

项目实现里对工具的声明式管理做得很明确：packages/gh/gh_mcp/impl.py 提供了 github_graphql 工具、DEFAULT_JQ 与 ToolAnnotations，并显式把某些工具标记为 readOnlyHint。这说明服务在设计中把副作用与只读查询区分开，便于 LLM 在调用外部工具时选择安全的查询路径，同时还能把复杂查询通过 DEFAULT_JQ 模板化为可重用的查询片段。

参考源码：packages/gh/gh_mcp/impl.py（github_graphql + DEFAULT_JQ + ToolAnnotations）

哲学

为 LLM 设计，不是开发者。