MCP Expert Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Utilizes environment variables for configuration, particularly for storing the Anthropic API key

  • Uses Node.js as the runtime environment for the MCP server, requiring version 18 or higher

  • Implements the server using TypeScript for type safety and modularity in the codebase

MCP エキスパート サーバー

Claude AIを活用したインテリジェントなクエリ生成とドキュメント作成支援を提供するモデルコンテキストプロトコルサーバーです。このサーバーはAPIドキュメントを分析し、以下の2つの主要ツールを提供します。

  • create-query : 自然言語リクエストに基づいてクエリを生成する
  • ドキュメント: 質問に基づいて関連するドキュメント情報を提供します

前提条件

  • Node.js >= 18
  • クロードのAnthropic APIキー

インストール

  1. リポジトリをクローンする
  2. 依存関係をインストールします:
npm install
  1. Anthropic API キーを使用して.envファイルを作成します。
ANTHROPIC_API_KEY=your_api_key_here

設定

サーバーを実行する前に、次のことを行う必要があります。

  1. プロジェクトをビルドし、セットアップ スクリプトを実行します。
npm run build npm run setup

これにより、次のようになります。

  • 必要なディレクトリ( docs/prompts/ )を作成します。
  • デフォルトのプロンプトファイルを作成する
  • 初期のサービス説明を生成する
  1. APIドキュメントファイルをdocs/ディレクトリに追加します( .txt.md.jsonファイルをサポートします)。
  2. オプションで、 prompts/ディレクトリ内のプロンプトをカスタマイズします。
    • system-prompt.txt : クロードのメインシステムプロンプト
    • tool-metadata.txt : ツールの説明のための追加コンテキスト
    • query-metadata.txt : クエリ生成のための追加コンテキスト
    • service-description.txt : 自動生成されたサービスの説明

使用法

スタンドアロンサーバー

サーバーを起動します。

npm start

サーバーは、モデル コンテキスト プロトコルを介して 2 つのツールを公開します。

  • create-query : 自然言語リクエストに基づいてクエリを生成する
    { "name": "create-query", "arguments": { "request": "Find all users who signed up in the last week" } }
  • ドキュメント: ドキュメントから情報を取得する
    { "name": "documentation", "arguments": { "request": "How do I authenticate API requests?" } }

クロードデスクトップ統合

  1. この構成を Claude Desktop 構成ファイルに追加します。
{ "mcpServers": { "expert": { "command": "node", "args": ["/ABSOLUTE/PATH/TO/expert-server/build/index.js"], "env": { "ANTHROPIC_API_KEY": "your_api_key_here" } } } }
  1. /ABSOLUTE/PATH/TO/expert-serverサーバーのインストールへの実際の絶対パスに置き換えます。
  2. Claude Desktop を再起動します。

ディレクトリ構造

. ├── docs/ # Your API documentation files ├── prompts/ # System prompts and metadata │ ├── system-prompt.txt # Main system prompt │ ├── tool-metadata.txt # Tool description context │ ├── query-metadata.txt # Query generation context │ └── service-description.txt # Generated service description ├── src/ # Source code │ ├── index.ts # Entry point │ ├── server.ts # MCP server implementation │ └── services/ # Core services │ └── expertService.ts # Claude integration └── package.json

発達

  • プロジェクトをビルドします。
npm run build
  • サーバーはTypeScriptを使用し、モジュール型アーキテクチャを採用しています。
  • ClaudeとのやりとりはすべてExpertServiceクラスによって処理されます
  • デバッグログは[DEBUG]プレフィックス付きでstderrに書き込まれます。

トラブルシューティング

接続の問題が発生した場合:

  1. セットアップ スクリプトを実行したことを確認します。
npm run setup
  1. prompts/ディレクトリに必要なファイルがすべて存在することを確認します
  2. ANTHROPIC_API_KEYが正しく設定されていることを確認してください
  3. Claude Desktop の設定で絶対パスを使用する
  4. デバッグログ(stderrに書き込まれる)を確認する

環境変数

  • ANTHROPIC_API_KEY : Anthropic APIキー(必須)

ライセンス

マサチューセッツ工科大学

-
security - not tested
F
license - not found
-
quality - not tested

Claude AI を利用してインテリジェントなクエリを生成し、API ドキュメント分析に基づいてドキュメント支援を提供するモデル コンテキスト プロトコル サーバー。

  1. Prerequisites
    1. Installation
      1. Setup
        1. Usage
          1. Standalone Server
          2. Claude Desktop Integration
        2. Directory Structure
          1. Development
            1. Troubleshooting
              1. Environment Variables
                1. License
                  ID: 13bt2om5eq