nei-mcp-server

fastmcp をベースにしたツールサーバーで、NEIプラットフォームと連携し、NEIプロジェクトリソースをクエリする機能を提供します。

コア機能

本プロジェクトは、NEIプラットフォームの一般的な機能を一連のMCPツールとしてカプセル化し、迅速なクエリと統合を可能にします。サポートされているツールは以下の通りです：

• sync_nei_project: リモートのNEIプラットフォームから最新のプロジェクトデータを強制的に同期し、ローカルキャッシュを更新します。ローカルデータが最新ではないと疑われる場合や、最近変更されたバックエンドインターフェースやデータモデル情報を取得する必要がある場合に、まずこのツールを呼び出してください。

• search_interfaces_by_uri: インターフェース定義のURI（インターフェースパス）に基づいて、NEIプロジェクト内のインターフェースリソースを曖昧検索します。

• search_interfaces_by_url: NEIインターフェース詳細リンク内の pid および id に基づいて、インターフェースリソースを正確に検索します（例: http://nei.example.com/interface/detail/?pid=10135&id=13015）。

• search_interfaces_by_name: インターフェース名に基づいて、NEIプロジェクト内のインターフェースリソースを曖昧検索します。

• search_groups_by_name: グループ名に基づいて、NEIプロジェクト内のビジネスグループを検索します。

Related MCP server: YApi MCP Server

環境準備

• Node.js (v20以上を推奨)

• pnpm (オプション、推奨)

インストールと設定

1. プロジェクトのクローン

   git clone https://github.com/leila-huang/nei-mcp-server.git
   cd nei-mcp-server

2. 依存関係のインストール npmを使用する場合:

   npm install

   またはpnpmを使用する場合:

   pnpm install

デバッグツール

1. inspectデバッグ fastmcp の inspect コマンドを使用すると、ローカルで対話的にすべてのツールをテストできます。Webページ上で SERVER_URL と PROJECT_ID を設定する必要があります。

   npm run inspect

   このコマンドは対話型インターフェースを提供し、実行するツールを選択してパラメータを入力できるため、デバッグや探索に最適です。

2. mcpクライアントデバッグ

       {
         "mcpServers": {
             "nei-mcp-server": {
                 "command": "npx",
                 "args": ["tsx", "/PATH/TO/YOUR_PROJECT/src/index.ts"],
                 "env": {
                     "SERVER_URL": "xxx",
                     "PROJECT_ID": "xxx"
                 }
             }
         }
       }

mcp使用ガイド

```bash
{
    "mcpServers": {
        "nei-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@leila329/nei-mcp-server"
            ],
            "env": {
                "SERVER_URL": "xxx",
                "PROJECT_ID": "xxx"
            }
        }
    }
}
```

キャッシュメカニズム

パフォーマンスを向上させ、NEIサーバーへのリクエスト負荷を軽減するために、本プロジェクトではシンプルなキャッシュ戦略を実装しています：

1. メモリキャッシュ: データは初回読み込み後にメモリに保存されます。サービスの実行中、同じリクエストはメモリから直接返されるため、重複したネットワークリクエストを回避できます。サービスを再起動すると、メモリキャッシュはクリアされます。

2. ネットワーク同期: サービス起動時、または sync_nei_project ツールを手動で呼び出した際に、NEIリモートサーバーから最新のプロジェクトデータを取得し、メモリキャッシュを更新します。

sync_nei_project ツールを呼び出すことで、手動でネットワーク同期を強制的にトリガーし、データが最新バージョンであることを確認できます。