MCP Patterns 是一套面向 Model Context Protocol (MCP) 的服务器模式参考，用于构建与 Claude Code 的集成。资料以 Python 示例为主，配合若干 references 文档覆盖常见开发场景。
一、用途 该项目旨在提供构建 MCP 服务器时的模式与代码参考，帮助开发者将自定义工具和能力接入 Claude Code。触发场景包括 mcp server、model context protocol、tool handler 等。
二、主要能力
- 基础 MCP 服务器示例（Python）：基于 mcp.server 的 Server 类与 stdio_server，实现 list_tools 与 call_tool 处理器。
- 项目结构建议：给出 my-mcp-server 的目录布局，包含 src/my_server 下的 server.py（主服务器逻辑）、tools.py（工具处理器）、resources.py（资源处理器），以及 pyproject.toml 和 README.md。
- Claude Desktop 配置示例：提供基础配置（python 命令）以及使用 uv 的推荐配置。
- 模式速查表：将工具校验、错误处理、多工具注册、静态资源、动态资源、环境认证、OAuth 令牌、SQLite 缓存、内存缓存、手动测试、pytest 异步测试等模式映射到对应的 references 文档。
- 常见问题排查：涉及服务器无法启动、工具不显示、认证失败、超时错误、JSON 解析错误等。
- 官方文档与资源链接：MCP 规范、工具与资源参考、Python SDK、官方 MCP 服务器仓库。
三、使用方式 资料给出 Python 示例代码，展示如何定义工具列表与调用逻辑，并通过 stdio_server 运行服务器。配置方面，需在 Claude Desktop 配置文件中添加 mcpServers 条目，指定 command（python 或 uv）、args 和 env 环境变量。更详细的模式需加载 ./references/ 下的对应文档，包括 tool-patterns.md、resource-patterns.md、auth-patterns.md、state-patterns.md、testing-patterns.md。
四、适用场景 适用于需要为 Claude Code 开发 MCP 服务器、注册工具处理器、暴露静态或动态资源、处理 API Key 或 OAuth 认证、实现缓存与持久化状态、以及编写测试的开发者。
五、限制 资料仅聚焦于 Python 实现（示例与 SDK 均为 Python）。未提供安装命令、价格、收费模式、完整 API 细节或各 references 文档的具体内容，部分事实暂未提供。