Myaiserv

🚀 MCP サーバー

MCP サーバーは、テキスト分析、画像処理、天気検索などのさまざまな操作をサポートする、さまざまなツールと機能を提供するプラットフォームです。REST API と WebSocket を介したインタラクションも可能です。以下は、MCP サーバーに関する詳細な説明です。

🚀 クイックスタート

📦 インストール

Poetryを使用したインストール

poetry install

Dockerを使用したインストール

docker compose up -d

🔛 起動

Poetryを使用した起動

インストールが完了したら、以下のコマンドでプロジェクトを起動します。

poetry run serve

Dockerを使用した起動

docker compose up -d

✨ 主な機能

ツールインターフェース

• テキスト分析ツール：感情分析、キーワード抽出などをサポートします。
• 画像処理ツール：画像の拡大縮小、切り取り、フィルター適用をサポートします。
• 天気検索ツール：緯度と経度に基づいて天気情報を提供します。
• テキスト処理ツール：テキストの整形、統計分析、エンティティ認識をサポートします。

REST API

すべてのツールのリストを取得する

curl http://localhost:8000/tools

特定のツールを実行する

curl -X POST http://localhost:8000/tools/{tool_name}

WebSocket インターフェース

WebSocket サービスに接続するには、以下のコードを使用します。

const socket = new WebSocket("ws://localhost:8000/ws");

socket.onopen = () => {
  socket.send(JSON.stringify({
    type: "initialize",
    id: "my-request-id"
  }));
};

socket.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log("Received:", data);
};

GraphQL インターフェース

GraphQL を使用して、クエリとミューテーション操作を行うことができます。例えば：

# すべてのツールをクエリする
query {
  getTools {
    name
    description
  }
}

# 特定のツールを実行する
mutation {
  executeTool(input: {
    name: "text_processor",
    parameters: {
      operation: "statistics",
      text: "Example text for analysis"
    }
  }) {
    content {
      type
      text
    }
    is_error
  }
}

💻 使用例

テストの実行

Poetryを使用したテストの実行

poetry run pytest

Dockerを使用したテストの実行

docker compose up -d && docker compose exec web poetry run pytest

LLM モデルの統合

MCP サーバーは、さまざまな LLM プロバイダーとの統合をサポートしています。以下は使用例です。

import httpx

async def query_with_llm(prompt: str):
    async with httpx.AsyncClient() as client:
        # すべてのツールの情報を取得する
        tools_response = await client.get("http://localhost:8000/tools")
        tools = tools_response.json()["tools"]

        # LLM サービスにリクエストを送信する
        llm_response = await client.post(
            "https://api.example-llm.com/v1/chat",
            json={
                "messages": [
                    {"role": "system", "content": "You have access to the following tools:"},
                    {"role": "user", "content": prompt}
                ],
                "tools": tools,
                "tool_choice": "auto"
            }
        )

        return llm_response.json()

メトリクスの取得

MCP サーバーは、Prometheus 形式のメトリクスを提供します。以下のエンドポイントから取得できます。

curl http://localhost:8000/metrics

これらのメトリクスには、各ツールのリクエスト数、リクエスト時間、エラー率などが含まれます。

📚 ドキュメント

コードの整形とチェック

以下のコマンドを使用して、コードの整形とチェックを行います。

just fmt
just lint

📄 ライセンス

MIT License