Kirha Crypto Smithery Gateway

🚀 Kirha Smithery Gateway

Kirhaツールの計画を行うための、Smitheryと連携可能な設定可能なMCP（Model Context Protocol）サーバーです。

✨ 主な機能

• 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

これにより、以下の内容がログに記録されます：

• 設定の読み込み
• ツールの登録
• ツールの実行
• エラー詳細