Bridges Torna API documentation system (hosted on Gitee) with AI assistants, enabling natural language search of APIs, retrieval of detailed API definitions, generation of curl commands, and project switching capabilities.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Torna MCP Serverfind APIs for user authentication and generate a curl command for login"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
torna-mcp
MCP server that bridges Torna API documentation system with AI assistants (Cursor, Claude Desktop, etc.). Query, search, and explore your Torna API docs through natural language.
What it does
This server exposes Torna's API documentation as MCP tools, resources, and prompts. Your AI assistant can:
Search APIs by keyword or natural language requirement
Retrieve detailed API definitions
Generate curl command examples
Switch between projects
Access project metadata
Features
Zero-config authentication: Credentials cached per connection, no repeated input
Batch operations: Fetch multiple API details concurrently
Smart matching: Natural language requirement → matching APIs
Project switching: Switch Torna projects on the fly
Quick Start
Installation
Run
Or with Docker:
Configure in Cursor
Add to ~/.cursor/mcp.json:
Restart Cursor and select the torna MCP server.
Usage Examples
Find APIs by requirement
You: "I need an API to query user information"
AI: Uses torna-find-apis-by-need to match APIs, returns:
User detail API (
/api/user/detail)User list API (
/api/user/list)
Search by keyword
You: "Find all APIs related to 'parking'"
AI: Uses torna-search-docs with keyword "parking", returns matching APIs.
Get API details
You: "Get details for these three APIs: JzAM4Mzp,AbC123Xy,Def456Za"
AI: Uses torna-get-doc-detail with comma-separated docIds, fetches all concurrently.
Switch projects
You: "What projects are available? Switch to user-center project"
AI: Lists projects via torna-list-projects, switches via torna-select-project.
Generate curl command
You: "Generate a curl command for the user detail API"
AI: Uses torna-generate-request to produce a ready-to-use curl command.
MCP Tools
All tools automatically use cached authentication from connection headers.
Tool | Description |
| Get current session info (username, project ID/name, token status, doc count) |
| Search APIs by keyword. Returns full tree if keyword is empty |
| Get API detail(s). Supports single or comma-separated docIds (batch, concurrent) |
| List all accessible spaces/projects |
| Switch active project for subsequent operations |
MCP Resources
config://settings- Server configuration exampletorna://session/project- Current session project infotorna://projects- Real-time project list
MCP Prompts
torna-find-apis-by-need- Find APIs matching a natural language requirement. Auto-fetches details for projects with ≤30 APIs for better matching.torna-generate-request- Generate curl command from API definition
Development
Environment Variables
PORT- Server port (default: 3000)MCP_URL- MCP server base URL (default: http://localhost:3000)
Logging
[TornaExternal]- Actual Torna API requests/responses[TornaAPI]- MCP responses to clients[MCPAuth]- Authentication events[MCPCapture]- MCP request capture
Architecture
The server acts as a proxy between MCP clients and Torna, handling:
Authentication (login, token caching)
Request routing (MCP tools → Torna endpoints)
Response transformation (Torna format → MCP format)
Contributing
Fork the repository
Create a feature branch
Make changes
Submit a pull request
Keep it simple. No unnecessary abstractions.
License
MIT