MCP Server Exploration

🚀 MCP 簡介

MCP 是一個使用 Connect API 的客戶端和服務器的簡單示例項目，它能幫助開發者快速瞭解如何運用 Connect API 構建客戶端與服務器。

🚀 快速開始

📦 安裝指南

運行一個 MCP 服務器：

CONNECT_API_KEY="你的密鑰" SWAGGER_FILE="swagger.yaml" make server

然後運行 MCP 客戶端：

make client

💻 使用示例

基礎用法

若要提出不同問題，可在 app.py 主函數中的聊天部分進行修改。

高級用法

Swagger 使用說明

以下是一個如何將 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 信息並返回工具調用的函數（如上所示）