MCP 简介

一个使用 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信息并返回工具调用的函数（如上所示）