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 許可證。