Kirha Crypto Smithery Gateway

🚀 Kirha Smithery Gateway

Kirha Smithery Gateway 是一個可配置的 MCP（模型上下文協議）服務器，專為 Kirha 工具規劃設計，可隨時與 Smithery 配合使用。

✨ 主要特性

• JSON 配置：可輕鬆配置工具、業務領域和 API 端點。
• 動態工具註冊：工具會根據配置進行註冊。
• 基於會話的 API 密鑰：每個會話都有自己的 API 密鑰，確保工具執行的安全性。
• 調試模式：開發時可選擇開啟調試日誌。
• 模塊化架構：工具存於單獨文件中，實現了清晰的關注點分離。

📦 安裝指南

環境配置（smithery.yaml）

runtime: "container"
startCommand:
  type: "http"
  configSchema:
    type: "object"
    properties:
      apiKey:
        type: "string"
        description: "Your API key"
      debug:
        type: "boolean"
        description: "Enable debug logging"
        default: false
      configPath:
        type: "string"
        description: "Path to custom configuration file"
    required: ["apiKey"]

JSON 配置（config.json）

{
  "mcp": {
    "name": "kirha-crypto",
    "version": "1.0.0"
  },
  "tool": {
    "name": "execute-crypto-tool-planning",
    "title": "Crypto Tool Planning",
    "description": "Execute crypto-related tool planning",
    "enabled": true
  },
  "vertical": "crypto",
  "api": {
    "executeToolPlanningUrl": "https://api.kirha.ai/chat/v1/tool-planning/execute",
    "summarization": {
      "enable": true,
      "model": "kirha-flash"
    }
  }
}

📚 詳細文檔

創建不同業務領域的分支

若要為不同的業務領域創建分支，請按以下步驟操作：

1. 將 config.example.json 複製為 config.json。
2. 更新配置：
   • 將 mcp.name 更改為你的業務領域名稱。
   • 將 vertical 更新為你的業務領域 ID。
   • 使用你特定的工具修改 tool 對象。
   • 更新 tool.name、tool.title 和 tool.description。

項目結構

src/
├── index.ts              # 主服務器入口點
├── types.ts              # 類型定義
└── tools/
    └── toolPlanning.ts   # 工具規劃實現

開發步驟

# 安裝依賴
npm install

# 在開發模式下運行
npm run dev

# 為生產環境構建
npm run build

# 啟動構建後的服務器
npm start

添加新工具

1. 在 src/tools/ 目錄下創建一個新文件（例如 newTool.ts）。
2. 按照 ToolRegistrationFunction 類型實現工具註冊函數。
3. 將該工具添加到 src/index.ts 中的 availableTools 映射中。
4. 更新你的 config.json 以包含新工具。

會話管理

• 每個客戶端連接都會從 Smithery 獲取自己的 API 密鑰。
• 配置在連接時綁定。
• 工具可以訪問特定於會話的配置。
• API 密鑰會安全地傳遞給工具執行函數。

調試模式

在會話配置中設置 debug: true 以啟用調試模式：

GET /mcp?apiKey=your-key&debug=true

這將記錄以下信息：

• 配置加載
• 工具註冊
• 工具執行
• 錯誤詳情