通用模型上下文协议（MCP）服务器

这是一个可以自定义工具和功能的通用 MCP 服务器骨架，可扩展。

安装

1. 克隆此仓库：

git clone <your-repo-url>
cd <repo-directory>

2. 安装依赖项：

pnpm install

3. 构建项目：

pnpm run build

使用 Claude 桌面进行设置

要将此 MCP 服务器与 Claude Desktop 一起使用，需要将其添加到 Claude 的配置文件中。编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

1. 打开配置文件：

open ~/Library/Application\ Support/Claude/claude_desktop_config.json

2. 在 mcpServers 对象中添加以下配置：

{
  "mcpServers": {
    "datadog-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/your/dist/index.js"],
      "env": {
        "DD_API_KEY": "your_api_key",
        "DD_APP_KEY": "your_app_key",
        "DD_HOST": "https://api.datadoghq.eu",
        "NODE_ENV": "production"
      },
      "disabled": false,
      "alwaysAllow": true
    }
  }
}

注意事项：

1. 将 /absolute/path/to/your 替换为您项目实际路径的 dist 目录。
2. 在 DD_API_KEY 中设置您的 Datadog API 密钥。
3. 在 DD_APP_KEY 中设置您的 Datadog 应用密钥。
4. 根据需要调整 DD_HOST，如果您使用的是不同区域。

注意：请确保 API 密钥的安全性，绝不要将其提交到版本控制中。

开发

项目结构

• index.ts: 包含 MCP 服务器实现的主要文件
• tsconfig.json: TypeScript 配置
• package.json: 项目依赖和脚本

添加新工具

1. 使用 Zod 定义您的工具模式：

const MyToolSchema = z.object({
  // 您的工具参数
});

2. 将您的工具添加到 ListToolsRequestSchema 处理器中：

{
  name: "my_tool",
  description: "描述您的工具功能",
  inputSchema: zodToJsonSchema(MyToolSchema) as ToolInput,
}

3. 在 CallToolRequestSchema 处理器中实现您的工具：

case "my_tool": {
  const parsed = MyToolSchema.safeParse(args);
  if (!parsed.success) {
    throw new Error(`我的工具参数无效：${parsed.error}`);
  }
  // 您的工具实现
  return {
    content: [{ type: "text", text: "您的工具响应" }],
  };
}

脚本

• pnpm run build: 构建 TypeScript 项目
• pnpm run prepare: 在发布前运行构建
• pnpm run watch: 监控更改并自动重建

依赖项

• @modelcontextprotocol/sdk: MCP 服务器 SDK
• zod: 模式验证
• zod-to-json-schema: 将 Zod 模式转换为 JSON Schema
• TypeScript 和相关开发工具

许可证

MIT