1. MCP概述
1.1 什么是MCP
MCP(Model Context Protocol) 是由Anthropic公司提出的开放协议,旨在标准化大语言模型与外部资源和工具之间的连接方式。
1.2 MCP的核心价值
MCP可被视为AI世界的"USB标准"或"驱动程序框架":
- 让大语言模型安全、统一地访问外部工具
- 打破生态壁垒,实现工具互操作性
- 降低AI应用开发成本
2. MCP架构原理
2.1 核心组件
2.1.1 MCP客户端
- 通常是大语言模型应用本身
- 负责发送用户请求并接收模型回复
2.1.2 MCP服务器
- 独立程序,专门连接特定资源或工具
- 向客户端宣告提供的工具和资源
2.1.3 MCP协议
- 基于JSON-RPC的通信格式
- 定义工具发现、调用和数据传输规范
2.2 工作流程
用户请求 → 客户端 → 大语言模型 → 识别需要工具
↓
调用MCP服务器 → 执行操作 → 返回结果
↓
大语言模型生成回复 → 客户端 → 用户
3. MCP开发实战
3.1 开发环境准备
Node.js环境
npm init -y
npm install @modelcontextprotocol/sdk
Python环境
pip install mcp
3.2 创建基础MCP服务器
Node.js版本
// server.js
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import {
CallToolRequestSchema,
ListToolsRequestSchema,
} from "@modelcontextprotocol/sdk/types.js";
// 创建服务器实例
const server = new Server(
{
name: "my-first-mcp-server",
version: "1.0.0",
},
{
capabilities: {
tools: {},
},
}
);
// 注册可用工具
server.setRequestHandler(ListToolsRequestSchema, async () => {
return {
tools: [
{
name: "get_weather",
description: "获取指定城市的天气信息",
inputSchema: {
type: "object",
properties: {
city: {
type: "string",
description: "城市名称"
}
},
required: ["city"]
}
},
{
name: "calculate",
description: "执行数学计算",
inputSchema: {
type: "object",
properties: {
expression: {
type: "string",
description: "数学表达式,如 2+2*3"
}
},
required: ["expression"]
}
}
]
};
});
// 处理工具调用
server.setRequestHandler(CallToolRequestSchema, async (request) => {
const { name, arguments: args } = request.params;
try {
switch (name) {
case "get_weather":
return {
content: [
{
type: "text",
text: `城市 ${args.city} 的天气:晴朗,25°C`
}
]
};
case "calculate":
const result = eval(args.expression);
return {
content: [
{
type: "text",
text: `${args.expression} = ${result}`
}
]
};
default:
throw new Error(`未知工具: ${name}`);
}
} catch (error) {
throw new Error(`执行失败: ${error.message}`);
}
});
// 启动服务器
async function main() {
const transport = new StdioServerTransport();
await server.connect(transport);
console.error("My MCP Server 正在运行...");
}
main().catch(console.error);
Python版本
# server.py
import asyncio
from mcp import Server, StdioServerTransport
from mcp.types import Tool, TextContent, CallToolRequest
class MyMCPServer:
def __init__(self):
self.server = Server("my-first-mcp-server", "1.0.0")
async def handle_list_tools(self) -> list[Tool]:
return [
Tool(
name="get_weather",
description="获取指定城市的天气信息",
inputSchema={
"type": "object",
"properties": {
"city": {"type": "string", "description": "城市名称"}
},
"required": ["city"]
}
),
Tool(
name="calculate",
description="执行数学计算",
inputSchema={
"type": "object",
"properties": {
"expression": {"type": "string", "description": "数学表达式"}
},
"required": ["expression"]
}
)
]
async def handle_call_tool(self, request: CallToolRequest):
name = request.params.name
args = request.params.arguments
if name == "get_weather":
return [TextContent(type="text", text=f"城市 {args['city']} 的天气:晴朗,25°C")]
elif name == "calculate":
result = eval(args['expression'])
return [TextContent(type="text", text=f"{args['expression']} = {result}")]
else:
raise ValueError(f"未知工具: {name}")
async def run(self):
async with StdioServerTransport() as transport:
await self.server.connect(transport)
self.server.set_list_tools_handler(self.handle_list_tools)
self.server.set_call_tool_handler(self.handle_call_tool)
print("My MCP Server 正在运行...", file=sys.stderr)
await self.server.wait_until_done()
if __name__ == "__main__":
server = MyMCPServer()
asyncio.run(server.run())
3.3 配置Claude Desktop
创建配置文件 ~/.config/Claude/claude_desktop_config.json:
{
"mcpServers": {
"my-first-server": {
"command": "node",
"args": ["/path/to/your/server.js"]
}
}
}
3.4 高级示例:笔记管理MCP
// notes-server.js
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
class NotesManager {
constructor() {
this.notes = new Map();
this.nextId = 1;
}
addNote(title, content) {
const id = this.nextId++;
this.notes.set(id, { id, title, content, createdAt: new Date() });
return id;
}
getNote(id) {
return this.notes.get(Number(id));
}
listNotes() {
return Array.from(this.notes.values());
}
searchNotes(query) {
return this.listNotes().filter(note =>
note.title.includes(query) || note.content.includes(query)
);
}
}
const notesManager = new NotesManager();
const server = new Server({ name: "notes-server", version: "1.0.0" });
server.setRequestHandler(ListToolsRequestSchema, async () => ({
tools: [
{
name: "create_note",
description: "创建新笔记",
inputSchema: {
type: "object",
properties: {
title: { type: "string", description: "笔记标题" },
content: { type: "string", description: "笔记内容" }
},
required: ["title", "content"]
}
},
{
name: "list_notes",
description: "列出所有笔记",
inputSchema: { type: "object", properties: {} }
},
{
name: "search_notes",
description: "搜索笔记",
inputSchema: {
type: "object",
properties: {
query: { type: "string", description: "搜索关键词" }
},
required: ["query"]
}
}
]
}));
server.setRequestHandler(CallToolRequestSchema, async (request) => {
const { name, arguments: args } = request.params;
switch (name) {
case "create_note":
const id = notesManager.addNote(args.title, args.content);
return {
content: [{
type: "text",
text: `笔记创建成功!ID: ${id}`
}]
};
case "list_notes":
const notes = notesManager.listNotes();
if (notes.length === 0) {
return { content: [{ type: "text", text: "暂无笔记" }] };
}
return {
content: [{
type: "text",
text: "所有笔记:\n" + notes.map(n =>
`ID: ${n.id} | 标题: ${n.title} | 时间: ${n.createdAt.toLocaleString()}`
).join('\n')
}]
};
case "search_notes":
const results = notesManager.searchNotes(args.query);
return {
content: [{
type: "text",
text: results.length > 0
? `找到 ${results.length} 条笔记:\n` + results.map(n =>
`ID: ${n.id} | 标题: ${n.title}`
).join('\n')
: "未找到相关笔记"
}]
};
}
});
4. 最佳实践
4.1 安全性考虑
- 避免使用eval()等危险函数
- 验证所有输入参数
- 实施权限控制
4.2 错误处理
- 完善的异常捕获机制
- 清晰的错误信息返回
- 日志记录和监控
4.3 性能优化
- 工具调用的异步处理
- 资源管理和清理
- 缓存策略实施
5. 其他MCP含义
5.1 Master Control Program
- 计算机系统中的核心控制程序
- 早期大型机和分布式系统使用
5.2 Microsoft Certified Professional
- 微软认证专家
- IT行业专业资质认证
6. 总结
MCP作为AI领域的重要协议,为构建可扩展、安全的AI应用提供了标准化解决方案。通过本文的指南,开发者可以快速上手MCP服务器开发,为AI助手扩展丰富的外部能力。
核心优势总结:
- 安全性与沙盒化
- 标准化与互操作性
- 可扩展性
- 降低开发成本