🚀 MCP - 模型上下文协议

模型上下文协议（MCP） 是一个开放标准，它能够让开发者建立安全的双向连接，将数据源与AI工具相结合，为开发工作带来极大便利。其架构简单易懂，开发者既可以通过MCP服务器暴露自己的数据，也能构建AI应用程序（MCP客户端）来连接这些服务器。

👉 了解更多

🚀 快速开始

模型上下文协议（MCP）遵循客户机 - 服务器架构，主机应用程序可以连接到多个服务器。

✨ 主要特性

• 作为开放标准，支持开发者建立安全的双向连接，将数据源与AI工具结合。
• 采用简单的架构，方便开发者通过MCP服务器暴露数据或构建MCP客户端连接服务器。
• 遵循客户机 - 服务器架构，主机应用程序可连接多个服务器。

📚 详细文档

架构

• src/：存放TypeScript源代码。
• build/：存放编译后的JavaScript代码。

weather/
├── src/        # TypeScript源代码
│   └── index.ts
├── build/      # 编译后的JavaScript代码
│   └── index.js
├── tsconfig.json
└── package.json

src/ 目录（TypeScript源代码）

目的：

• 包含开发阶段的TypeScript代码。
• 在此实现MCP协议处理程序（资源、工具、提示）。
• 还包含逻辑、类型定义、SDK等。

关键文件：

• index.ts：MCP服务器的入口点。
• MCP概念：
  • resources/：MCP资源实现。
  • tools/：LLM可调用函数。
  • prompts/：提示模板 / 管理。

build/ 目录（编译后的JavaScript代码）

目的：

• 存放TS编译后的运行时代码。
• 这是Claude Desktop通过node build/index.js进行交互的文件夹。

特性：

• 编译后得到可用于生产环境的JavaScript代码。
• 此阶段无需TypeScript。
• 输出清晰，便于部署。

⚙️ 数据流管道

graph LR
    A[开发者编写TS代码] --> B[src/index.ts]
    B --> C[tsc TypeScript编译器]
    C --> D[build/index.js]
    D --> E[Node.js运行时]
    E --> F[Claude Desktop IPC]

index.js之后发生的事情

一旦index.js准备就绪，流程如下： Claude Desktop ↔ stdio ↔ 服务器传输 ↔ McpServer ↔ 工具（1）