MCP - Model Context Protocol

MCP - 模型上下文协议

关于 MCP

**模型上下文协议（MCP）**是一项开放标准，使开发者能够在数据源与 AI 驱动的工具之间建立安全的双向连接。其架构简单明了：开发者可以通过 MCP 服务公开数据，也可以构建连接这些服务的 AI 应用（MCP 客户端）。

👉 了解更多

---

MCP 遵循客户端-服务端架构，主机应用可以连接多个服务。

---

架构

src/ → TypeScript 源代码
build/ → 编译后的 JavaScript

```bash
weather/
├── src/        # TypeScript source
│   └── index.ts
├── build/      # Compiled JavaScript
│   └── index.js
├── tsconfig.json
└── package.json

---

src/ 目录（TypeScript 源代码）

用途：

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

关键文件：

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

---

build/ 目录（编译后的 JavaScript）

用途：

• 存放 TS 编译后的运行时代码
• Claude Desktop 通过以下命令与此文件夹交互：
  node build/index.js

特点：

• 已编译、可用于生产环境的 JavaScript
• 此阶段之后不再需要 TS
• 输出内容简洁，可部署

---

⚙️ 数据流管线

graph LR
    A[Developer Writes TS Code] --> B[src/index.ts]
    B --> C[TypeScript Compiler tsc]
    C --> D[build/index.js]
    D --> E[Node.js Runtime]
    E --> F[Claude Desktop IPC]

index.js 之后会发生什么

index.js 准备就绪后，流程如下：

Claude Desktop ↔ stdio ↔ 服务端传输 ↔ McpServer ↔ 工具（1）