API MCP (api-mcp)

MCP开发工具

提供方 koseha

开发工具 未标注 Token 社区 / 第三方 Claude DesktopClaudeCursor

基于Swagger/OpenAPI规范的API文档查询工具,提供API列表和详细信息的检索功能。

一句话选型结论

按资料字段整理

API MCP (api-mcp) 属于开发工具类 MCP 服务器,传输方式未标注,Token,可直接接入 Claude Desktop、Claude、Cursor,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权Token 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 2 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量2暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

API文档TypeScript本地部署OpenAPISwagger开发工具API管理

安装与配置

未标注 Token
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 2 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 2 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
API MCP (api-mcp)当前 2 未标注 未标注 无 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方koseha上游标注的维护方 koseha
分类开发工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

4.8 KB
来自项目仓库与上游目录的原文,未做删改

API MCP服务器

基于Swagger/OpenAPI规范的Model Context Protocol(MCP)服务器。提供通过OpenAPI文档查询API列表和详细信息的工具。

功能

“工具”(Tools)

  • getApiList -查看API列表

  • 在OpenAPI规范中查看所有API端点的列表。

  • 返回类型:每个路径的HTTP方法和 tags, operationId, summary 信息

  • getApiDetail -查看API详细信息

  • 查询特定API的详细信息。

  • 参数: requestUrl (字符串), httpMethod (获取 · 发布 · 放置 · 删除 · 补丁)
  • 返回类型: parameters, requestBody, responses 信息

资源(Resources)

  • greeting://{name} -动态问候语生成资源

安装

安装为NPM软件包```bash

npm install @koseha/api-mcp


或者```bash
npm install @koseha/api-mcp@latest

使用方法

方法1:在Cursor IDE中使用

添加到Cursor设置文件:```
{
"mcpServers": {
"api-mcp": {
"command": "node",
"args": ["./node_modules/@koseha/api-mcp/dist/index.js"],
"env": {
"OPENAPI_URL":
}
}
}
}


### 方法2:在Claude Desktop中使用

添加到Claude Desktop配置文件:

**macOS:**```
~/Library/Application Support/Claude/claude_desktop_config.json

窗户:```
%APPDATA%\Claude\claude_desktop_config.json


设置示例:```json
{
"mcpServers": {
"api-mcp": {
"command": "npx",
"args": ["-y", "@koseha/api-mcp"],
"env": {
"OPENAPI_URL": "https://api.example.com/openapi.json"
}
}
}
}

或使用本地路径:```json
{
"mcpServers": {
"api-mcp": {
"command": "node",
"args": ["/path/to/api-mcp/dist/index.js"],
"env": {
"OPENAPI_URL": "https://api.example.com/openapi.json"
}
}
}
}


### 方法3:直接在Node.js项目中使用```javascript
import { spawn } from "child_process";

const mcpServer = spawn("npx", ["-y", "@koseha/api-mcp"], {
stdio: ["pipe", "pipe", "pipe"],
});

// JSON-RPC 요청 보내기
function sendRequest(method, params) {
const request = {
jsonrpc: "2.0",
id: Date.now(),
method,
params: params || {},
};
mcpServer.stdin?.write(JSON.stringify(request) + "\n");
}

// API 목록 조회
sendRequest("tools/call", {
name: "getApiList",
arguments: {},
});

// API 상세 조회
sendRequest("tools/call", {
name: "getApiDetail",
arguments: {
requestUrl: "/pet/{petId}/uploadImage",
httpMethod: "post",
},
});

方法4:在本地开发中使用

使用npm link

在当前项目中:```bash
npm link


在其他项目中:```bash
npm link @koseha/api-mcp

使用相对路径

其他项目的 package.json添加到:```json
{
"dependencies": {
"@koseha/api-mcp": "file:../api-mcp"
}
}


## 开发

### 前提条件

- Node.js 18或更高版本
- npm或yarn

### 安装```bash
npm install

构建```bash

npm run build


### 执行```bash
npm start

或开发模式:```bash
npm run dev


## 项目结构```
api-mcp/
├── src/
│   ├── index.ts              # MCP 서버 엔트리포인트
│   ├── server.ts             # 서버 생성 로직
│   ├── tools/                # 도구 모듈
│   │   ├── index.ts
│   │   ├── getApiList.tool.ts    # API 목록 조회 도구
│   │   └── getApiDetail.tool.ts  # API 상세 조회 도구
│   ├── resources/            # 리소스 모듈
│   │   ├── index.ts
│   │   └── greeting.resource.ts
│   └── swagger/              # Swagger 로더 및 변환기
│       ├── swaggerLoader.ts
│       ├── apiTransformer.ts
│       ├── schemaResolver.ts
│       └── types.ts
├── dist/                     # 빌드된 파일
├── openapi.json             # OpenAPI 스펙 파일
├── package.json
├── tsconfig.json
└── README.md

OpenAPI规格设置

OPENAPI_URL 必须通过环境变量设置OpenAPI文档的URL。如果在服务器启动时未设置此环境变量,服务器将无法启动。

示例:bash export OPENAPI_URL=https://api.example.com/openapi.json

依赖性

生产依赖性

  • @modelcontextprotocol/sdk:MCP SDK(^1.25.1)
  • zod:模式验证(^4.2.1)

开发依赖性

  • typescript:类型脚本编译器(^5.9.3)
  • @types/node:Node.js类型定义(^25.0.3)
  • ts-node:TypeScript执行工具(^10.9.2)

版本

当前版本: 0.0.10

历史

版本日期更改
0.0.10 KST2025.12.31-将OpenAPI文档更改为按HTTP请求加载
-添加OPENAPI_URL环境变量必需验证
-API详细查询逻辑重构(apiTransformer模块化)|
0.0.7 KST2025.12.31--tool请求时,仅提取并使用openapi.json文档的特定部分
>>禁用整个openapi.json文档内容。节省token |

许可证

国际学生委员会

参考资料

  • MCP官方文档
  • MCP SDK GitHub
  • OpenAPI规格

贡献

热点或完整请求 GitHub存储库欢迎。

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
API MCP (api-mcp) 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

API MCP (api-mcp) 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

API MCP (api-mcp) 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

API MCP (api-mcp) 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

API MCP (api-mcp) 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

API MCP (api-mcp) 能提供哪些能力?

资料显示约 2 个工具;能力标签包括 API集成、API文档、TypeScript、Claude、开发工具。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。