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