MCP Api Server

🚀 MCP API 服務器

MCP API 服務器是以 API 為核心的模型上下文協議（MCP）服務器，具備身份驗證和 API 調用功能。它支持通過 MCP 工具進行安全的 API 調用，同時能有效管理身份驗證和響應處理。

🚀 快速開始

MCP API 服務器允許你通過 MCP 工具進行安全的 API 調用，以下是使用前的準備和啟動步驟。

✨ 主要特性

• 🔑 基於令牌的身份驗證管理
• 📞 製作經過身份驗證的外部服務 API 調用
• 🔐 安全的令牌管理與身份驗證狀態跟蹤
• 📋 使用 MCP 協議結構的 Well - typed 響應
• 📄 不同內容類型（JSON、文本）的響應格式化

📦 安裝指南

先決條件

• 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 集成

此服務器可以通過模型上下文協議與 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 服務器：

• BUILD_MCP_SERVER_GUIDE.md：從頭開始創建模型上下文協議服務器的詳細教程，解釋核心概念、實現細節和最佳實踐。

該指南涵蓋：

• 項目設置與結構
• MCP 架構基礎原理
• 核心組件構建
• 身份驗證實現
• 創建自定義工具
• 測試與 VS Code 集成
• 高級功能建議

無論是初學者還是有經驗的開發者，都能在此指南中找到有關實現自己的 MCP 服務器的有價值信息。

🔧 技術細節

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