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

安装

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

此服务器可以通过模型上下文协议与 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 获取车辆数据。

无需参数。

数据结构

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