Automcp

🚀 AutoMCP

AutoMCPは、モデルコンテキストプロトコル 用のサーバーとクライアントコードを自動生成するコード生成ツールです。YAML形式のサービス定義に基づいて自動的にコードを生成します。

このプロジェクトは現在開発中です。このリポジトリには、最終バージョンでnpmやpyplなどにパッケージ化される前に削除される一時ファイルが含まれています。

このツールをエージェントワークフローで使用する方法については、MCP Agent を参照してください。

✨ 主な機能

• MCPに互換性のあるサーバーコードを自動生成します。
• サービスを簡単に利用できるクライアントライブラリを生成します。
• ツール機能を実装するハンドラースタブを作成します。
• サービスごとに独立したディレクトリでコードを整理します。

🚀 クイックスタート

前提条件

• Node.js 18 以上
• npm または yarn

📦 インストール

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

💻 使用例

サービスの定義

services/[サービス名]/ ディレクトリに、以下の構造のYAMLファイルを作成します。

service:
  name: ServiceName
  version: 1.0.0
  description: サービスの説明を記述します。

tools:
  - name: toolName
    description: ツールの機能を説明します。
    parameters:
      - name: paramName
        type: string
        description: パラメータの説明
    returns:
      type: string
      description: 戻り値の説明

コードの生成

生成スクリプトを実行します。

./bin/automcp.sh generate

これにより、以下の操作が行われます。

1. generated/[サービス名]/[サービス名]_server.ts にサーバーコードが作成されます。
2. generated/[サービス名]/[サービス名]_client.ts にクライアントコードが作成されます。
3. src/custom/[サービス名]/[ツール名]Handlers.ts にハンドラースタブが作成されます。

ハンドラーの実装

src/custom/[サービス名]/ に生成されたハンドラーファイルを編集して、ツール機能を実装します。

生成されたクライアントの使用

import { ServiceNameClient } from "./generated/service-name/service_name_client.js";

async function main() {
  const client = new ServiceNameClient();

  try {
    await client.connect();

    // ツールを呼び出す
    const result = await client.toolName({ paramName: "value" });
    console.log(result);
  } finally {
    await client.disconnect();
  }
}

main().catch(console.error);

サンプル

生成されたクライアントの使用方法の完全なサンプルについては、examples/client_example.ts ファイルを参照してください。

テスト

サービスの機能を検証するには、以下のテストスクリプトを使用します。

./bin/test-service.sh [サービス名]

一時的なディレクトリ構造（パッケージ化のために改善予定）

.
├── bin/                    # スクリプト
├── examples/               # 使用例
├── generated/              # 生成されたコード
│   ├── service-name/       # サービス固有の生成コード
│   │   ├── service_name_server.ts
│   │   └── service_name_client.ts
├── services/               # サービス定義
│   └── service-name/       # サービス名
│       └── service.yaml    # サービスのYAMLファイル
└── src/
    └── custom/[サービス名]/ # カスタムハンドラー

将来の計画

• より多くのサービス定義形式（JSON、XMLなど）をサポートします。
• 異なる言語（Python、Javaなど）のクライアント生成をサポートします。
• より複雑なツールパラメータの検証とエラー処理を実装します。
• 設定とサービス管理を容易にするグラフィカルユーザーインターフェイスを提供します。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されており、自由な使用、変更、配布が許可されています。詳細については、LICENSE ファイルを参照してください。