🌟 OpenAPI Tool Servers

🌟 OpenAPI Tool Servers

site icon
2025.04.18 282
PythonAPI 集成工具开发开发效率
OpenAPI Tool Servers 是一个提供参考实现的 OpenAPI 工具服务器项目,旨在帮助开发者轻松、安全地将外部工具和数据源集成到 LLM 代理和工作流中。该项目基于广泛采用的 OpenAPI 规范,消除了对专有或不熟悉通信协议的需求,使开发者能够快速构建或集成服务器,从而专注于增强 AI 应用的强大工具。
View on GitHub

Overview

🌟 基本能力

产品定位

OpenAPI Tool Servers 旨在为开发者提供参考实现的 OpenAPI 工具服务器,简化外部工具和数据源的集成过程,特别适用于 LLM 代理和工作流。

核心功能

  • 标准化协议:基于 OpenAPI 规范,确保广泛兼容性和易用性。
  • 快速集成:提供参考实现,支持快速部署和集成。
  • 安全性:支持 HTTPS、OAuth、JWT 和 API Keys 等安全通信方法。
  • 灵活性:支持本地或外部部署,无供应商锁定。

适用场景

  • LLM 代理集成:将外部工具和数据源集成到 LLM 代理中。
  • 工作流自动化:通过 OpenAPI 规范自动化工作流。
  • 工具开发:快速构建或集成工具服务器。

工具列表

  • Filesystem Access:安全管理本地文件操作。
  • Git Server:通过 API 端点暴露 Git 仓库操作。
  • Database Server:查询和检查常见数据库引擎的模式。
  • Memory & Knowledge Graph:持久化内存管理和语义知识查询。
  • Web Search & Fetch:安全检索和转换网页内容为结构化 API 结果。

常见问题解答

  • 为什么选择 OpenAPI?:OpenAPI 是一个广泛使用的标准,支持多种工具和社区,无需学习新协议。
  • 如何贡献?:鼓励社区贡献自己的 OpenAPI 工具服务器示例。

🚀 使用教程

使用依赖

安装 FastAPI 或其他 OpenAPI 兼容库:

pip install fastapi

安装教程

克隆仓库并安装依赖:

git clone https://github.com/open-webui/openapi-servers
cd openapi-servers/servers/filesystem
pip install -r requirements.txt
uvicorn main:app --host 0.0.0.0 --reload

或使用 Docker:

cd servers/filesystem
docker compose up

调试方式

启动服务后,使用 OpenAPI 兼容客户端或 AI 代理访问本地或公开部署的 URL。

🔌 Bridge to MCP (Optional)

使用 mcpo 或 Python 代理服务器将 MCP 工具暴露为 OpenAPI 兼容 API:

uvx mcpo --port 8000 -- uvx mcp-server-time --local-timezone=America/New_York

或:

cd servers/mcp-proxy
pip install -r requirements.txt
python main.py --host 0.0.0.0 --port 8000 -- uvx mcp-server-time --local-timezone=America/New_York

许可证

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