Get Biji MCP

🚀 Get笔记 MCP Server

Get笔记 MCP Serverは、Get笔记 (GetBiji) APIと統合するためのModel Context Protocol (MCP) サーバーです。これにより、AIを活用した知識ベースの検索と取得機能が可能になります。

🚀 クイックスタート

Get笔记 MCP Serverを使用することで、Get笔记 APIと連携し、AIによる知識ベースの検索や取得ができます。以下の手順に従って、サーバーをセットアップしてください。

✨ 主な機能

• ✅ stdioトランスポートを備えたMCPサーバーフレームワーク
• ✅ Bearerトークン認証をサポートするGet笔记 APIクライアント
• ✅ レート制限 (2 QPS、1日5000リクエスト)
• ✅ 包括的なエラーハンドリングとロギング
• ✅ 完全な型安全性を備えたTypeScript
• ✅ 3つのMCPツール:
  • knowledge_search: AI強化型の知識ベース検索
  • knowledge_recall: 生のコンテンツの高速取得
  • get_rate_limit_stats: APIレート制限の使用統計の取得

📦 インストール

オプション1: グローバルにインストール (頻繁に使用する場合に推奨)

npm install -g mcp-get-biji-server

オプション2: npxを使用する (インストール不要)

npx mcp-get-biji-server

オプション3: プロジェクトの依存関係としてインストール

npm install mcp-get-biji-server

📚 ドキュメント

設定

1. 環境変数テンプレートをコピーします。

cp .env.example .env

2. .env ファイルを編集し、APIキーを追加します。

GET_BIJI_API_KEY=your_api_key_here
GET_BIJI_API_BASE_URL=https://open-api.biji.com/getnote/openapi
LOG_LEVEL=info
REQUEST_TIMEOUT=30000
RATE_LIMIT_QPS=2
RATE_LIMIT_DAILY=5000

Claude Desktopでの使用方法

Claude Desktopの設定ファイル (~/Library/Application Support/Claude/claude_desktop_config.json) を編集します。

グローバルインストールを使用する場合

{
  "mcpServers": {
    "get-biji": {
      "command": "mcp-get-biji-server",
      "env": {
        "GET_BIJI_API_KEY": "your_api_key_here",
        "GET_BIJI_DEFAULT_TOPIC_ID": "your_default_topic_id"
      }
    }
  }
}

npxを使用する場合

{
  "mcpServers": {
    "get-biji": {
      "command": "npx",
      "args": ["-y", "mcp-get-biji-server"],
      "env": {
        "GET_BIJI_API_KEY": "your_api_key_here",
        "GET_BIJI_DEFAULT_TOPIC_ID": "your_default_topic_id"
      }
    }
  }
}

ローカルインストールを使用する場合

{
  "mcpServers": {
    "get-biji": {
      "command": "node",
      "args": ["/path/to/node_modules/mcp-get-biji-server/build/index.js"],
      "env": {
        "GET_BIJI_API_KEY": "your_api_key_here",
        "GET_BIJI_DEFAULT_TOPIC_ID": "your_default_topic_id"
      }
    }
  }
}

Claude Desktopを再起動して、サーバーを有効にします。

MCPツールの説明

1. knowledge_search

AI強化型の検索で、深い処理を行った結果を返します。

パラメータ:

• question (必須): 検索クエリ
• topic_ids (必須): 知識ベースIDのリスト (現在は1つのみサポート)
• deep_seek (必須): 深い思考を有効にする
• refs (オプション): 参照を含める
• history (オプション): フォローアップのための会話履歴

2. knowledge_recall

AI処理を行わずに、生のコンテンツを高速に取得します。

パラメータ:

• question (必須): 検索クエリ
• topic_id (オプション): 単一の知識ベースID (優先)
• topic_ids (オプション): 知識ベースIDのリスト
• top_k (オプション): 上位の結果の数 (デフォルト: 10)
• intent_rewrite (オプション): 意図の書き換えを有効にする
• select_matrix (オプション): 結果の再選択を有効にする
• history (オプション): 会話履歴

注意: topic_id または topic_ids のいずれかを指定する必要があります。topic_id が優先されます。

3. get_rate_limit_stats

現在のAPIレート制限の使用統計を取得します。

開発コマンド

npm run build        # TypeScriptをコンパイル
npm run watch        # ウォッチモードでコンパイル
npm run dev          # ビルドして実行
npm test             # テストを実行
npm start            # 実行 (最初にビルドする必要があります)

APIレート制限

• QPS: 2リクエスト/秒
• 1日: 5000リクエスト/日

サーバーは、インテリジェントなキューイングによってレート制限を自動的に処理します。

プロジェクト構造

.
├── src/                  # ソースコード
│   ├── index.ts         # MCPサーバーのエントリーポイント
│   ├── client.ts        # APIクライアント
│   ├── config.ts        # 設定
│   ├── logger.ts        # ロギングシステム
│   ├── rate-limiter.ts  # レート制限器
│   ├── types.ts         # 型定義
│   └── test.ts          # テストスクリプト
├── build/               # コンパイルされた出力
├── .env                 # 環境変数
└── package.json         # プロジェクトの設定

技術スタック

• Node.js (ESモジュール)
• TypeScript
• @modelcontextprotocol/sdk
• Axios
• dotenv

📄 ライセンス

MIT

貢献

貢献を歓迎します！issueを開くか、pull requestを送信してください。

小胰宝 と 小x宝コミュニティ の貢献と開発に対して特別な感謝を申し上げます。彼らは、愛と人工知能を持ってがん/希少疾患患者とその家族を支援しています！