MCP Server Exploration

🚀 MCP 概要

Connect API を使用したクライアントとサーバーのシンプルなサンプルです。

🚀 クイックスタート

📦 インストール

MCP サーバーを起動するには、以下のコマンドを実行します。

CONNECT_API_KEY="あなたのAPIキー" SWAGGER_FILE="swagger.yaml" make server

次に、MCP クライアントを起動します。

make client

app.py のメイン関数内のチャット部分を変更することで、異なる質問を行うことができます。

💻 使用例

基本的な使用法

以下は、Swagger ツールを Chatlas に登録するコードの例です。

import chatlas
import requests
from openapi_mcp.chatlas import SwaggerTool
from openapi_mcp.connect_api import map_operations_to_tools
from openapi_mcp.swagger import (
    expand_all_references,
    transform_swagger_to_operation_dict,
)

api_url = "127.0.0.1:8000/"
openapi_dict = requests.get(f"{api_url}/swagger.json").json()

openapi_doc = expand_all_references(openapi_dict)
operations = transform_swagger_to_operation_dict(openapi_doc)
tools = map_operations_to_tools(operations)

aws_model = os.getenv("AWS_MODEL", "us.anthropic.claude-3-5-sonnet-20241022-v2:0")
aws_region = os.getenv("AWS_REGION", "us-east-1")
chat = chatlas.ChatBedrockAnthropic(model=aws_model, aws_region=aws_region)
for operation in api_operations.values():
    SwaggerTool.register_tool(
        chat,
        SwaggerTool(
            base_url=api_url,
            operation=operation,
        ),
    )

実際の動作を確認するには、ローカルの互換性のある OpenAPI サーバーを起動し、Shiny アプリケーションを起動します。

# ローカルの互換性のある OpenAPI サーバーを起動
make ex-starwars

# Shiny を起動
make shiny

📚 ドキュメント

タスクの説明

• [x] Swagger ファイルを読み込む
• [x] Swagger ファイル内の参照オブジェクトを展開する: doc = expand_swagger(doc)
• [x] Swagger ファイルとツール呼び出しの間の橋渡しを行う
• [x] ツールを Chatlas に登録する
• [x] 汎用的な Swagger ファイルを処理する関数を作成する: operations = transform_swagger_to_operation_dict(doc)
• [x] すべての mcp_servers を openapi_mcp メソッドに移動する
• [x] Shiny チャットアプリケーションを作成する
  • [x] plumber API URL を受け付ける
  • [x] ホームページに Swagger ドキュメントを表示する
  • [x] 新しい関数を利用する
• [x] ライブラリとしてパッケージ化する
  • [x] Swagger 情報を受け取り、ツール呼び出しを返す関数をエクスポートする（上記の通り）