Smithery Registry OpenAPI Server

Smithery Registry OpenAPI Server

site icon
2025.04.06 0
PythonAPI 接口MCP 服务器管理开发效率
Smithery Registry OpenAPI Server 是一个提供 OpenAPI 接口的服务,用于搜索和获取 Model Context Protocol (MCP) 服务器的启动配置。它支持高级过滤、详细的服务器信息获取、WebSocket URL 生成以及基于 bearer token 的认证。
View on GitHub

Overview

基本能力

产品定位

Smithery Registry OpenAPI Server 是一个为 MCP 服务器提供 OpenAPI 接口的服务,主要用于搜索和获取 MCP 服务器的启动配置。

核心功能

  • 列出可用的 MCP 服务器,并支持高级过滤
  • 获取详细的服务器信息,包括连接配置
  • 生成带有 base64 编码配置的 WebSocket URL
  • 通过 bearer token 进行认证
  • 兼容 OpenAPI 工具和客户端

适用场景

  • 开发者在需要搜索和连接 MCP 服务器时
  • 需要生成 WebSocket URL 以连接到 MCP 服务器的场景
  • 使用 OpenAPI 工具进行 API 集成和测试

工具列表

  • OpenAPI 工具和客户端:用于 API 集成和测试
  • TypeScript SDK:用于与 Smithery SDK 集成

常见问题解答

  • 如何获取 bearer token? 从 Smithery 用户个人资料的 API 密钥部分获取。
  • 如何生成 WebSocket URL? 使用 /create-websocket-url 端点,并提供合格的名称和配置对象。

使用教程

使用依赖

pip install -r requirements.txt

安装教程

uvicorn main:app --host 0.0.0.0 --port 8000 --reload

调试方式

  • 访问 /docs 端点查看详细的 OpenAPI 文档
  • 使用 OpenAPI 工具进行 API 测试

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。