🚀 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 集成：
- 在项目中创建一个
.vscode文件夹（如果不存在） - 添加以下配置到
mcp.json文件：
{
"servers": {
"api-mcp-server": {
"type": "stdio",
"command": "sh",
"args": [
"-c",
"cd /path/to/mcp-api-server && npm run build && npm run start"
]
}
}
}
- 将
/path/to/mcp-api-server替换为项目的绝对路径 - 重启 VS Code 或重新加载窗口
- 兼容的 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