Torna MCP

🚀 Torna MCP Server

Torna MCP Serverは、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

🚀 クイックスタート

インストール

方法1：PyPIを通じてインストール（推奨）

# pipを使用する
pip install toma-mcp

# またはuvを使用する（推奨）
uv pip install toma-mcp

方法2：ソースコードからインストール

git clone https://github.com/li7hai26/torna-mcp.git
cd torna-mcp
pip install -e .
# またはuvを使用する
uv pip install -e .

環境変数の設定

# Tornaサーバーのアドレスを設定する
export TORNA_URL="http://localhost:7700/api"

# モジュールアクセストークンを設定する
export TORNA_TOKEN="your-module-token-here"

トークンの取得方法:

1. Torna管理バックエンドにログインする
2. プロジェクトを選択する
3. モジュールを選択する
4. OpenAPIタブをクリックする
5. トークンをコピーする

環境変数ファイル: 環境変数ファイルを使用する場合：

cp .env.example .env
# .envファイルを編集し、TORNA_URLとTORNA_TOKENを設定する

MCPサーバーの起動

torna-mcp

起動後、サーバーは標準出力に接続情報を表示し、これをMCPクライアントに設定して使用できます。

✨ 主な機能

コアAPIインターフェース (2つのツール)

実際のTorna OpenAPI仕様に基づいて実装されています：

• ドキュメントをプッシュする (torna_push_document) - TornaにAPIドキュメントをプッシュする

  • カテゴリ/フォルダの作成をサポート
  • リクエスト/レスポンスパラメータの定義をサポート
  • エラーコードの設定をサポート
  • デバッグ環境の設定をサポート

• ドキュメントを取得する (torna_get_document) - 単一のドキュメントの詳細情報を取得する

  • ドキュメントの完全な情報を取得
  • リクエスト/レスポンスパラメータを含む
  • エラーコード情報を含む

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"
    }
  }
}

3. Claude Desktopを再起動する

IFlow CLI

# MCP設定に追加する
iflow mcp add toma-mcp

詳細なクライアント設定の説明は MCP_CLIENTS.md を参照してください。

💻 使用例

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": "张三"
}

ドキュメントの詳細を取得する

ツール: toma_get_document
パラメータ:
{
  "doc_id": "doc_123"
}

カテゴリ（フォルダ）を作成する

ツール: 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"
}

🔧 技術詳細

環境要件

• Python: 3.8 以上のバージョン
• Torna: プライベートデプロイメントバージョン
• MCPクライアント: Cursor、Claude Desktop、VS Codeなど

Python環境のインストール

• pip (標準のPythonインストール)
• uv (推奨 - より高速で現代的なパッケージマネージャー)

  # uvをインストールする
  curl -LsSf https://astral.sh/uv/install.sh | sh
  

📚 ドキュメント

• クイックスタート - 詳細なクイックスタートガイド
• インストールガイド - 複数のインストール方法
• MCPクライアントの設定 - 各種MCPクライアントの設定方法
• デプロイメントガイド - 本番環境でのデプロイメントの説明

🐛 問題の報告

使用中に問題が発生した場合は、以下の方法で報告してください：

1. GitHub Issues を確認する
2. PyPIページでフィードバックを送信する
3. メールを送信する: li7hai26@gmail.com

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。

👨‍💻 開発者

• 作者: 阿拉丁神灯
• メール: li7hai26@gmail.com
• GitHub: @li7hai26

🔗 関連リンク

• PyPIパッケージ
• GitHubリポジトリ
• Tornaプロジェクト