Api2mcptools

🚀 @terryliyongjie/api2mcptools

このパッケージは、API を MCP（モデルコンテキストプロトコル）に変換するための Node.js ツールです。CherryStudio などのサービスでの利用が可能です。

日本語ドキュメント

• CherryStudio の例 CherryStudio

🚀 クイックスタート

このパッケージを使用することで、API を MCP に簡単に変換できます。以下の手順に従って、素早く始めましょう。

✨ 主な機能

• JSON API を MCP ツールに変換します。
• MCP エコシステムとの統合が容易です。
• 複数の API タイプをサポートしています。
• コマンドラインインターフェイス（CLI）をサポートしています。

📦 インストール

オプション 1：npx を使用してすぐに始める（推奨）

set CONFIG_JSON_PATH=example.json
npx @terryliyongjie/api2mcptools

オプション 2：従来のインストール

# プロジェクト内にローカルインストール
npm install @terryliyongjie/mcp-tools

# または、CLI ツールとしてグローバルインストール
npm install -g @terryliyongjie/mcp-tools

📚 ドキュメント

環境変数

# 必須：JSON 設定ファイルのパスを設定する
CONFIG_JSON_PATH=example.json

設定ファイルの例（example.json）：

// 単一のツール設定
{
    "name": "tool_name",
    "description": "ツールの説明",
    "inputSchema": {
        "type": "object",
        "properties": {
            "param1": {
                "type": "string",
                "description": "パラメータの説明"
            }
        },
        "required": ["param1"]
    },
    "axiosConfig": {
        "url": "https://api.example.com/endpoint",
        "method": "get",
        "params": {
            "key": "your_api_key"
        }
    }
}

// または、複数のツール設定
[
    {
        "name": "baidu_place_search",
        "description": "百度地図 API を使用した場所検索サービス",
        "inputSchema": {
            "type": "object",
            "properties": {
                "query": {
                    "type": "string",
                    "description": "検索キーワード"
                },
                "region": {
                    "type": "string",
                    "description": "検索する行政区画"
                }
            },
            "required": ["query", "region"]
        },
        "axiosConfig": {
            "url": "https://api.map.baidu.com/place/v2/search",
            "method": "get",
            "params": {
                "ak": "your_baidu_map_key"
            }
        }
    },
    // その他のツール...
]

💻 使用例

基本的な使用法

CLI ツールとして

グローバルインストール後、ターミナルで次のコマンドを使用できます。

mcp-tools [options]

モジュールとして

// サンプルコードは近日公開予定です。

🔧 技術詳細

開発

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

# 開発モードで実行する
npm run dev

# 開発中にファイルの変更を監視する
npm run watch

# MCP チェッカーを実行する
npm run inspector

📄 ライセンス

MIT