Skip to main content
Glama

Torna MCP Server

by li7hai26
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote
MIT License
1

Torna MCP Server

PyPI Python License GitHub

<<<<<<< HEAD 一个用于与 Torna 接口文档管理平台交互的 MCP（模型上下文协议）服务器。该服务器基于真实的 Torna OpenAPI 规范，提供了5个完整工具，允许 LLM 通过标准化的接口来管理 Torna 中的 API 文档。

基于真实 Torna API 规范: http://localhost:7700/api

======= 一个用于与 Torna 接口文档管理平台交互的 MCP（模型上下文协议）服务器。该服务器基于真实的 Torna OpenAPI 规范，提供了2个核心工具，允许 LLM 通过标准化的接口来管理 Torna 中的 API 文档。

基于真实 Torna API 规范: http://localhost:7700/api

🎉 发布状态

项目已成功发布到PyPI！

  • 包名: torna-mcp

  • 版本: 1.0.0

  • PyPI页面: https://pypi.org/project/torna-mcp/

  • 许可证: MIT

  • Python支持: >=3.8

55eee9a1cddd378865fe2faccee51a0c205a87ea

🚀 快速开始

安装

<<<<<<< HEAD

方法1：通过 uv 安装（推荐）

# 安装 uv（如果尚未安装） curl -LsSf https://astral.sh/uv/install.sh | sh # 安装包 uv add toma-mcp # 或使用 pip pip install toma-mcp ======= #### 方法1：通过PyPI安装（推荐） ```bash # 使用 pip pip install toma-mcp # 或使用 uv（推荐） uv pip install toma-mcp >>>>>>> 55eee9a1cddd378865fe2faccee51a0c205a87ea

方法2：从源码安装

<<<<<<< HEAD # 使用 uv uv pip install -e . # 或使用 pip pip install -e . ======= git clone https://github.com/li7hai26/torna-mcp.git cd torna-mcp pip install -e . # 或使用 uv uv pip install -e . >>>>>>> 55eee9a1cddd378865fe2faccee51a0c205a87ea

配置环境变量

# 设置Torna服务器地址 export TORNA_URL="http://localhost:7700/api" # 设置模块访问令牌 export TORNA_TOKEN="your-module-token-here"

获取Token方法:

  1. 登录 Torna 管理后台

  2. 选择项目

  3. 选择模块

  4. 点击 OpenAPI 标签

  5. 复制 token

环境变量文件: 如果您使用环境变量文件：

cp .env.example .env # 编辑 .env 文件，设置您的 TORNA_URL 和 TORNA_TOKEN

<<<<<<< HEAD

55eee9a1cddd378865fe2faccee51a0c205a87ea

启动MCP服务器

torna-mcp

启动后，服务器将在标准输出显示连接信息，您可以将其配置到MCP客户端中使用。

📚 功能特性

<<<<<<< HEAD

核心 API 接口 (5个工具)

=======

核心 API 接口 (2个工具)

55eee9a1cddd378865fe2faccee51a0c205a87ea

基于真实的 Torna OpenAPI 规范实现：

  • 推送文档 (torna_push_document) - 向 Torna 推送 API 文档

    • 支持创建分类/文件夹

    • 支持请求/响应参数定义

    • 支持错误码配置

    • 支持调试环境设置

<<<<<<< HEAD

  • 获取单个文档详情 (torna_get_document_detail) - 获取单个文档详细信息 =======

  • 获取文档 (torna_get_document) - 获取单个文档详细信息

55eee9a1cddd378865fe2faccee51a0c205a87ea

  • 获取文档完整信息

  • 包括请求/响应参数

  • 包括错误码信息

<<<<<<< HEAD

  • 获取模块信息 (torna_get_module) - 获取应用模块基本信息

    • 模块名称和描述

    • 模块状态信息

  • 列出所有文档 (torna_list_documents) - 获取完整文档列表

    • 获取所有文档和文件夹

    • 支持分类结构

    • 解决“获取所有文档详情”问题

  • 批量获取文档详情 (torna_get_document_detail_batch) - 批量获取多个文档详情

    • 一次性获取多个文档详细信息

    • 高效处理大量文档

    • 完整参数列表

=======

55eee9a1cddd378865fe2faccee51a0c205a87ea API 规范: 基于 Torna 官方 OpenAPI 实现

🛠️ MCP客户端配置

Cursor

  1. 打开Cursor设置

  2. 找到MCP Servers配置

  3. 添加新服务器：

{ "mcpServers": { "torna-mcp": { "command": "torna-mcp", "env": { "TORNA_URL": "http://localhost:7700/api", "TORNA_TOKEN": "your-module-token-here" } } } }

Claude Desktop

  1. 编辑Claude配置文件

  2. 添加MCP服务器配置：

{ "mcpServers": { "torna-mcp": { "command": "torna-mcp" } } }

  1. 重启Claude Desktop

<<<<<<< HEAD

VS Code

  1. 安装MCP相关扩展

  2. 配置服务器连接

  3. 使用MCP工具 =======

IFlow CLI

# 添加到MCP配置 iflow mcp add toma-mcp

详细的客户端配置说明请参见 MCP_CLIENTS.md

55eee9a1cddd378865fe2faccee51a0c205a87ea

📝 使用示例

推送 API 文档

工具: toma_push_document 参数: { "name": "用户登录", "description": "用户登录接口", "url": "/api/auth/login", "http_method": "POST", "content_type": "application/json", "request_params": [ { "name": "username", "type": "string", "description": "用户名", "required": true, "example": "john_doe" }, { "name": "password", "type": "string", "description": "密码", "required": true, "example": "123456" } ], "response_params": [ { "name": "token", "type": "string", "description": "访问令牌" }, { "name": "userId", "type": "string", "description": "用户ID" } ], "author": "张三" }

获取文档详情

<<<<<<< HEAD 工具: torna_get_document_detail ======= 工具: toma_get_document >>>>>>> 55eee9a1cddd378865fe2faccee51a0c205a87ea 参数: { "doc_id": "doc_123" }

<<<<<<< HEAD

批量获取文档详情

工具: torna_get_document_detail_batch 参数: { "doc_ids": ["doc_123", "doc_456", "doc_789"] }

获取模块信息

工具: torna_get_module 参数: {}

列出所有文档

工具: torna_list_documents 参数: {}

=======

55eee9a1cddd378865fe2faccee51a0c205a87ea

创建分类（文件夹）

工具: toma_push_document 参数: { "name": "用户管理", "description": "用户相关的API接口", "url": "", "http_method": "GET", "is_folder": true }

带调试环境的文档

工具: toma_push_document 参数: { "name": "商品查询", "description": "查询商品信息", "url": "/api/products/{id}", "http_method": "GET", "content_type": "application/json", "path_params": [ { "name": "id", "type": "int", "description": "商品ID", "required": true, "example": "123" } ], "debug_env_name": "测试环境", "debug_env_url": "http://localhost:8080" }

🔧 系统要求

环境要求

<<<<<<< HEAD

  • Python: 3.11 或更高版本

  • Torna: 私有化部署版本

  • MCP客户端: Cursor、Claude Desktop、VS Code等

开发工具

  • uv: 现代 Python 包管理器

  • pytest: 测试框架

  • black: 代码格式化

  • isort: 导入排序

  • mypy: 类型检查

🧪 开发

安装开发依赖

uv sync --dev

运行测试

uv run pytest

代码格式化

uv run black src/ tests/ uv run isort src/ tests/

类型检查

uv run mypy src/

=======

  • Python: 3.8 或更高版本

  • Torna: 私有化部署版本

  • MCP客户端: Cursor、Claude Desktop、VS Code等

安装Python环境

  • pip (标准Python安装)

  • uv (推荐 - 更快更现代的包管理器)

    # 安装uv curl -LsSf https://astral.sh/uv/install.sh | sh

📖 详细文档

🐛 问题反馈

如果您在使用过程中遇到问题，请：

  1. 查看 GitHub Issues

  2. 在PyPI页面提交反馈

  3. 发送邮件至: li7hai26@gmail.com

55eee9a1cddd378865fe2faccee51a0c205a87ea

📄 许可证

本项目采用 MIT 许可证，详情请参见 LICENSE 文件。

👨‍💻 开发者

  • 作者: 阿拉丁神灯

  • 邮箱: li7hai26@gmail.com

  • GitHub: @li7hai26

<<<<<<< HEAD

📋 变更日志

详细变更日志请查看 CHANGELOG.md

v0.1.0 (2025-11-12) - Beta版本

  • ✨ 初始版本发布

  • ✅ 基于真实 Torna OpenAPI 规范实现 (5个工具)

  • ✅ 解决"获取所有文档详情"的核心问题

  • 📦 使用 uv 进行现代化包管理

  • 🧪 添加完整测试套件

  • 🔧 遵循 MCP 开发通用规范

  • 🌏 支持国内镜像加速

=======

55eee9a1cddd378865fe2faccee51a0c205a87ea

🔗 相关链接

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/li7hai26/torna-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server