MCP Api Server

🚀 MCP API サーバー

このサーバーは、APIを中心としたモデルコンテキストプロトコル（MCP）サーバーで、認証とAPI呼び出し機能を提供します。MCPツールを通じて安全なAPI呼び出しを行い、認証とレスポンス処理を管理することができます。

✨ 主な機能

• トークンベースの認証管理
• 認証済みの外部サービスAPI呼び出しの実行
• 安全なトークン管理と認証状態の追跡
• MCPプロトコル構造を使用した型安全なレスポンス
• 異なるコンテンツタイプ（JSON、テキスト）のレスポンスフォーマット

📚 ドキュメント

このリポジトリには、MCPサーバーを構築するための詳細なステップバイステップガイドが含まれています。

• BUILD_MCP_SERVER_GUIDE.md：モデルコンテキストプロトコルサーバーをゼロから作成する詳細なチュートリアルで、核心概念、実装の詳細、およびベストプラクティスを説明しています。

このガイドは以下の内容をカバーしています。

• プロジェクトの設定と構造
• MCPアーキテクチャの基本原理
• 核心コンポーネントの構築
• 認証の実装
• カスタムツールの作成
• テストとVS Codeとの統合
• 高度な機能の提案

初心者でも経験豊富な開発者でも、このガイドから自分自身のMCPサーバーを実装するための有益な情報を見つけることができます。

📦 インストール

前提条件

• Node.js 16+
• npm

インストール手順

# リポジトリをクローンする
git clone https://github.com/ranjanmadhu/mcp-api-server.git
cd mcp-api-server

# 依存関係をインストールする
npm install

💻 使用例

基本的な使用法

サーバーを直接実行することができます。

# 開発モード
npm run dev

# または、ビルドして本番環境で実行する
npm run build
npm start

高度な使用法

このサーバーは、モデルコンテキストプロトコルを介して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. 互換性のあるAI拡張機能がMCPサーバーを使用できるようになります。

トラブルシューティング

• 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