返回-mcp
桥接的MCP服务器 返回 带有人工智能助手的API文档系统（Cursor、Claude Desktop等）。通过自然语言查询、搜索和探索Torna API文档。
它的作用
该服务器将Torna的API文档公开为MCP工具、资源和提示。您的AI助手可以：
- 按关键字或自然语言要求搜索API
- 检索详细的API定义
- 生成curl命令示例
- 在项目之间切换
- 访问项目元数据
特性
- 零配置身份验证：每个连接缓存凭据，无重复输入
- 批量操作：同时获取多个API详细信息
- 智能匹配：自然语言要求→ 匹配API
- 项目切换：动态切换Torna项目
快速开始
安装
git clone https://github.com/chenqi146/torna-mcp.git
cd torna-mcp
npm install
npm run build跑
npm start
# Server runs on http://localhost:3000或者使用Docker：
docker build -t torna-mcp .
docker run -p 3000:3000 torna-mcp在游标中配置
添加到 ~/.cursor/mcp.json:
{
"mcpServers": {
"torna": {
"transport": "http",
"url": "http://localhost:3000/mcp",
"heartbeat": true,
"headers": {
"username": "your_torna_username",
"password": "your_torna_password",
"projectid": "your_project_id",
"torna-base-url": "http://your-torna-server:7700"
}
}
}
}重新启动游标并选择 torna MCP服务器。
使用示例
按要求查找API
你： “我需要一个API来查询用户信息”
人工智能： 用途 torna-find-apis-by-need 为了匹配API，返回：
- API用户详细信息(
/api/user/detail) - API用户列表(
/api/user/list)
按关键字搜索
你： “查找与‘停车’相关的所有API”
人工智能： 用途 torna-search-docs 使用关键字“parking”，返回匹配的API。
获取API详细信息
你： “获取这三个API的详细信息：JzAM4Mzp、AbC123Xy、Def456Za”
人工智能： 用途 torna-get-doc-detail 使用逗号分隔的docIds，同时获取所有内容。
切换项目
你： “有哪些项目可用？切换到用户中心项目”
人工智能： 通过以下方式列出项目 torna-list-projects，通过以下方式切换 torna-select-project.
生成curl命令
你： “为用户详细信息API生成curl命令”
人工智能： 用途 torna-generate-request 生成一个即用型curl命令。
MCP工具
所有工具都会自动使用连接头中的缓存身份验证。
| 工具 | 说明 |
|---|---|
torna-project-info | 获取当前会话信息（用户名、项目ID/名称、令牌状态、文档计数） |
torna-search-docs | 按关键字搜索API。如果关键字为空，则返回完整树 |
torna-get-doc-detail | 获取API详细信息。支持单个或逗号分隔的docId（批处理、并发） |
torna-list-projects | 列出所有可访问的空间/项目 |
torna-select-project | 切换活动项目以进行后续操作 |
MCP资源
config://settings-服务器配置示例torna://session/project-当前会话项目信息torna://projects-实时项目列表
MCP提示
torna-find-apis-by-need-查找符合自然语言要求的API。自动获取API≤30的项目的详细信息，以便更好地匹配。torna-generate-request-从API定义生成curl命令
发展
# Install dependencies
npm install
# Development mode
npm run dev
# Build
npm run build
# Production
npm start环境变量
PORT-服务器端口（默认值：3000）MCP_URL-MCP服务器基本URL（默认值：http://localhost:3000)
日志记录
[TornaExternal]-实际Torna API请求/响应[TornaAPI]-MCP对客户的回应[MCPAuth]-身份验证事件[MCPCapture]-MCP请求捕获
建筑
AI Assistant (Cursor/Claude)
↓ MCP Protocol
torna-mcp Server (this project)
↓ HTTP Proxy
Torna API Server服务器充当MCP客户端和Torna之间的代理，处理：
- 身份验证（登录、令牌缓存）
- 请求路由（MCP工具→ Torna端点）
- 响应转换（Torna格式→ MCP格式）
贡献
- 复刻仓库
- 创建要素分支
- 进行更改
- 提交拉取请求
保持简单。没有不必要的抽象。
许可证
麻省理工学院