模型上下文协议资源
项目介绍
模型上下文协议资源与指南
此仓库是为学习模型上下文协议（MCP）过程中创建的一系列指南、实用工具和服务器实现。它反映了我对这个令人兴奋的新标准的持续探索和发展，用于创建强大的代理功能。欢迎提问和反馈！🚀
免责声明： 本仓库中的资源（指南、实用工具、服务器实现和MCP TypeScript模板）是由cyanheads在探索模型上下文协议时独立开发的。此项目并未正式隶属于模型上下文协议组织。官方MCP资源链接如下。 我非常感谢官方MCP团队在规范、SDK和文档方面的工作！
📋 目录
简介 | 指南 | 实用工具 | 服务器 | 开始使用 | 官方资源
🔍 MCP简介
模型上下文协议（MCP） 是一个开放标准，旨在标准化AI应用程序（客户端/主机）如何连接并交互外部数据源和工具（服务器）。可以将其视为AI领域的USB-C：一种通用方式，将功能插件到LLM应用程序中。
关键优势：
- 一致接口：标准化方法供LLMs访问工具和资源。
- 增强能力：使LLMs能够与数据库、API、本地系统等进行交互。
- 安全与控制：提供结构化的访问模式，内置验证和明确边界。
- 可扩展性：通过服务器轻松添加新功能，无需修改核心LLM应用程序。
- 模块化：开发和维护专门的功能，在隔离且可重用的服务器组件中。
要深入了解MCP，包括其设计理念和技术细节，请访问官方网站：modelcontextprotocol.io。
🚀 MCP TypeScript模板仓库
| 项目 | 描述 |
|---|---|
| mcp-ts-template | 提供一个适合初学者、生产就绪的模板，用于构建MCP服务器和客户端。包含必要的实用工具、示例和类型安全性，作为坚实起点。 |
📚 MCP指南
| 指南 | 描述 |
|---|---|
| MCP客户端开发指南 | 学习如何构建消耗MCP服务器能力的应用程序。涵盖核心架构、生命周期、工具/资源、安全、示例和高级主题。（注意：需要更新以适应最新规范变化） |
| MCP服务器开发指南 | 全面指导构建MCP服务器。涵盖核心架构、协议基础、服务器生命周期、传输（Stdio、流式HTTP）、使用TypeScript SDK构建、定义工具/资源/提示、高级特性（采样、根、流式传输、进度、订阅、完成）、安全最佳实践（更新至认证规范2025-03-26）、故障排除和示例实现。（更新于22025年5月） |
| Cyanhead的MCP 'llms.txt' | 一个自定义的llms.txt，用于快速开发TypeScript MCP服务器，使用高层次SDK（McpServer）。针对LLM消费，涵盖关键概念、高层次示例、安全性和动态能力，更新至规范2025-03-26及TS SDK v1.11.0。 |
🔧 MCP实用工具
| 项目 | 描述 |
|---|---|
| mcp-reporter | 生成全面的能力报告，帮助开发者理解其MCP生态系统中的可用功能，以便于文档编写和集成。 |
🔌 MCP服务器
此仓库托管了多个示例MCP服务器实现，展示了不同的能力：
| 项目 | 描述 |
|---|---|
| atlas-mcp-server | ATLAS（自适应任务和逻辑自动化系统），是一个基于Neo4j的任务管理系统，专为LLM代理设计。它采用三层架构（项目、任务、知识）来管理复杂的工作流程，并包括深度研究框架。 |
| clinicaltrialsgov-mcp-server | 使AI代理能够通过MCP从ClinicalTrials.gov搜索、检索和分析临床研究数据。 |
| filesystem-mcp-server | 通过MCP提供平台无关的文件系统能力，使AI代理能够管理文件和目录。具有高级搜索/替换和目录遍历功能。 |
| git-mcp-server | 提供企业级MCP接口用于Git操作，允许LLMs通过STDIO和流式HTTP初始化、克隆、分支、提交和管理仓库。 |
| github-mcp-server | 通过MCP集成GitHub API，为LLM代理提供结构化接口，管理仓库、问题、拉取请求、代码、文件和发布。 |
| mentor-mcp-server | 使用Deepseek API通过MCP提供AI驱动的导师服务，为LLM代理提供“第二意见”。可用于代码审查、设计批评、写作反馈和头脑风暴。 |
| ntfy-mcp-server | 通过MCP集成ntfy.sh推送通知服务，使LLMs能够向外部设备发送高度定制的通知。 |
| obsidian-mcp-server | 使LLMs能够通过MCP安全地与Obsidian保险库交互，提供令牌感知工具来管理笔记。促进无缝的知识库管理和属性管理。 |
| perplexity-mcp-server | 通过MCP解锁Perplexity的搜索增强AI能力。提供实时网络信息访问，具有强大的错误处理和安全验证。 |
| pubmed-mcp-server | 将AI代理连接到NCBI的PubMed和E-utilities，通过MCP实现生物医学文献的搜索、检索和分析。 |
| toolkit-mcp-server | 通过MCP为LLM代理提供基本的系统实用工具和工具。功能包括IP地理定位、网络诊断、系统监控、加密操作和二维码生成。 |
| workflows-mcp-server | 赋予AI代理强大的声明式工作流引擎，发现、理解和执行定义在简单YAML文件中的复杂多步骤工作流。就像询问你的LLM：“创建一个新的工作流，使用你当前可以访问的工具来做xyz” |
🚀 开始使用
- 浏览指南：使用客户端和服务器指南了解MCP概念和开发方法。
- 选择服务器：从MCP服务器部分选择一个符合你需要的服务器，并遵循其仓库中的具体设置说明。
- 连接客户端：使用现有的兼容MCP客户端（如Claude Desktop、Cline等）或根据客户端开发指南构建自己的客户端。
- 实验与贡献：尝试这些工具，并考虑通过相关项目仓库的问题或拉取请求进行贡献。
🔗 官方资源
指向官方模型上下文协议文档、规范和社区资源的关键链接(modelcontextprotocol.io)：
| 页面 / 部分 | 链接路径 |
|---|---|
| 简介 | /introduction |
| 服务器快速入门 | /quickstart/server |
| 规范主页 | /specification |
| ↳ 架构 | /specification/architecture |
| ↳ 基础协议 | /specification/basic |
| ↳ 服务器特性 | /specification/server |
| ↳ 客户端特性 | /specification/client |
| ↳ 认证规范 (2025-03-26) | /.../authorization |
| 架构定义 (TS) | spec/.../schema.ts |
| 贡献指南 | CONTRIBUTING.md |
| GitHub 组织 | github.com/... |
| 规范讨论 | spec/discussions |
| 组织讨论 | orgs/discussions |
| JSON-RPC 2.0 规范 | jsonrpc.org |
SDKs & 工具：
| 语言 | SDK 仓库 |
|---|---|
| TypeScript | typescript-sdk |
| Python | python-sdk |
| Kotlin | kotlin-sdk |
| Java | java-sdk |
| C# | csharp-sdk |
| 工具 | 仓库 |
| MCP Inspector (调试工具) | inspector |
<div align="center"> 由 <a href="https://github.com/cyanheads">cyanheads</a> 和模型上下文协议（MCP）创建 </div>