MCP API 服务器

一个以API为中心的模型上下文协议（MCP）服务器，提供身份验证和API调用功能。该服务器允许通过MCP工具进行安全的API调用，并管理身份验证和响应处理。

特性

• 基于令牌的身份验证管理
• 制作经过身份验证的外部服务API调用
• 安全的令牌管理与身份验证状态跟踪
• 使用MCP协议结构的Well-typed响应
• 不同内容类型（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 集成

此服务器可以通过模型上下文协议与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