MCP API Server

MCP API サーバー

認証機能と API 呼び出し機能を提供する、API に特化した Model Context Protocol（MCP）サーバーです。このサーバーを使用すると、認証管理とレスポンス処理を備えた MCP ツールを通じて、安全に API を呼び出せます。

アーキテクチャ

機能

• トークンベースのセキュリティによる認証管理
• 外部サービスへの認証付き API 呼び出し
• 認証状態の追跡による安全なトークン管理
• MCP プロトコル構造を使用した、型付けされたレスポンス
• 各種コンテンツタイプ（JSON、テキスト）に対応したレスポンスのフォーマット

ドキュメント

このリポジトリには、MCP サーバーの構築方法を段階的に解説する包括的なガイドが含まれています。

• BUILD_MCP_SERVER_GUIDE.md：コアコンセプト、実装の詳細、ベストプラクティスの説明とともに、Model Context Protocol サーバーをゼロから作成する手順を解説した詳細なチュートリアルです。

このガイドでは、次の内容を扱います。

• プロジェクトのセットアップと構成
• MCP アーキテクチャの基礎
• コアコンポーネントの構築
• 認証の実装
• カスタムツールの作成
• テストと VS Code との連携
• 高度な機能の提案

初めて MCP サーバーを実装する方にも、経験豊富な開発者にも、独自の MCP サーバーの実装に役立つ情報を提供します。

前提条件

• Node.js 16+
• npm

インストール

# Clone the repository
git clone https://github.com/ranjanmadhu/mcp-api-server.git
cd mcp-api-server

# Install dependencies
npm install

使用方法

サーバーを直接実行できます。

# Development mode
npm run dev

# Or build and run in production
npm run build
npm start

VS Code との連携

このサーバーは、Model Context Protocol を通じて VS Code と連携できます。

1. プロジェクト内に .vscode フォルダーを作成します（まだ存在しない場合）。
2. 次の設定を含む mcp.json ファイルを追加します。

{
  "servers": {
    "api-mcp-server": {
      "type": "stdio",
      "command": "sh",
      "args": [
        "-c",
        "cd /path/to/mcp-api-server && npm run build && npm run start"
      ]
    }
  }
}

3. /path/to/mcp-api-server をプロジェクトの絶対パスに置き換えます。
4. VS Code を再起動するか、ウィンドウを再読み込みします。
5. MCP サーバーを、互換性のある AI 拡張機能から利用できるようになります。

トラブルシューティング

• MCP サーバーに接続できない場合は、VS Code の開発者コンソールでエラーを確認してください。
• mcp.json 内のパスが正しく、アクセス可能であることを確認してください。
• npm run build でサーバーが正常にビルドされることを確認してください。

MCP との連携

この MCP サーバーは、次のツールを公開します。

1. auth

安全な API アクセスのための認証トークンを管理します。

パラメーター：

• action：実行する認証アクション（set、check、clear のいずれか）
• token：認証トークン（set アクションで必須）

2. vehicle_api

外部 API を呼び出して車両データを取得します。

パラメーターは不要です。

データ構造

API 呼び出しのレスポンスは、MCP プロトコルに準拠した形式で出力されます。

interface ToolResponse {
  content: Array<{
    type: "text" | "image" | "audio" | "resource";
    text?: string;
    data?: string;
    mimeType?: string;
    resource?: {
      text?: string;
      uri: string;
      blob?: string;
      mimeType?: string;
    };
  }>;
  _meta?: Record<string, unknown>;
  isError?: boolean;
}

ライセンス

MIT