Agi House Hackathon MCP Server

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

这是一个可自定义工具和功能的通用 MCP 服务器骨架，具备良好的扩展性，能满足多样化的使用需求。

🚀 快速开始

本部分将引导您完成通用 MCP 服务器的安装与初步配置，让您迅速开启使用之旅。

📦 安装指南

克隆仓库

首先，您需要克隆此仓库到本地，并进入项目目录：

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

安装依赖项

使用 pnpm 安装项目所需的依赖项：

pnpm install

构建项目

执行以下命令完成项目的构建：

pnpm run build

💻 使用示例

使用 Claude 桌面进行设置

若要将此 MCP 服务器与 Claude Desktop 配合使用，需将其添加到 Claude 的配置文件中。以下是详细步骤：

打开配置文件

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

添加配置

在 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
    }
  }
}

注意事项

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

⚠️ 重要提示

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

🔧 技术细节

项目结构

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

添加新工具

定义工具模式

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

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

添加工具到处理器

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

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

实现工具

在 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 许可证。