SuperAPI AI 工具集

mcp

智能体与模型

查看项目

更新于 10-16 03:42

技能介绍

用途:本资料介绍如何构建 MCP(Model Context Protocol)服务器,使 Claude 能访问外部工具与数据,包括查询数据库、调用 API、访问文件系统以及运行自定义工具。适合需要让 Claude 读取实时数据、减少重复手动 API 调用,或让 Claude 执行创建记录、触发工作流等操作的场景。

主要能力:通过 @modelcontextprotocol/sdk 定义工具(server.tool),用 zod 校验输入,并以 StdioServerTransport 启动服务器。资料给出数据库访问(Postgres,仅允许 SELECT)、API 封装(如 get_weather)、文件系统访问(如 list_projects)等常见模式示例。

使用方式:初始化项目可执行 mkdir my-mcp-server && cd my-mcp-server、pnpm init、pnpm add @modelcontextprotocol/sdk zod、pnpm add -D typescript @types/node tsx。package.json 中设置 type 为 module 及 dev/build/start 脚本,tsconfig.json 使用 ES2022、NodeNext 等配置。基础模板从 @modelcontextprotocol/sdk/server/mcp.js 引入 McpServer,注册工具后连接 StdioServerTransport。在 Claude Desktop 中需将服务器配置写入 ~/Library/Application Support/Claude/claude_desktop_config.json 的 mcpServers 字段,指定 command、args 与 env,修改后重启 Claude Desktop。测试可运行 echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | pnpm start。

限制与安全:资料建议用 Zod 校验所有输入、数据库访问限制为 SELECT(除非有意放开)、不在工具响应中暴露密钥,并考虑对外部 API 做速率限制。参考链接包括 MCP 文档、MCP SDK 与 Anthropic 的 mcp-builder。