SuperiorAPIs MCP Server Tool

📖 基本能力

产品定位

SuperiorAPIs MCP Server Tool 是一个动态API工具生成和管理的MCP服务器，旨在简化API工具的集成和管理过程。

核心功能

• 动态插件加载：从SuperiorAPIs动态获取插件定义。
• 自动生成工具函数：基于OpenAPI模式自动生成pydantic模型和异步函数。
• 异步API执行：使用aiohttp进行异步API调用。
• 运行时MCP工具注册：在运行时动态注册MCP工具。
• 环境配置支持：支持通过环境变量进行配置。
• UVX平台部署就绪：可直接部署到UVX平台。

适用场景

• 需要动态加载和管理API工具的开发环境。
• 快速集成第三方API工具的项目。
• 需要自动化API工具生成和管理的场景。

工具列表

• post_example_tool: 一个示例工具函数，用于演示如何生成和使用MCP工具。

常见问题解答

• API调用失败：如果API调用失败或返回status: 0，程序将退出并提示错误信息。请检查API是否正常工作。

⚙️ 使用教程

使用依赖

安装项目依赖：

pip install -r requirements.txt

安装教程

克隆项目并安装依赖：

git clone https://your-repo-url.git
cd your-repo
pip install -r requirements.txt

调试方式

运行MCP服务器：

python main.py

服务器将执行以下步骤： 1. 从SuperiorAPIs获取插件数据。 2. 动态生成MCP工具函数。 3. 注册工具。 4. 启动MCP服务器。

🌍 环境变量

在运行前，设置以下环境变量：

Linux/macOS

export TOKEN=your_token_here
export APPLICATION_ID=your_application_id_here

Windows CMD

set TOKEN=your_token_here
set APPLICATION_ID=your_application_id_here

📦 打包（可选）

构建包：

python setup.py sdist bdist_wheel

安装包：

pip install dist/mcp-superiorapis-1.0.0-py3-none-any.whl

使用Docker运行（如果需要）：

docker build -t superiorapis-mcp .
docker run -e TOKEN=your_token -e APPLICATION_ID=your_app_id superiorapis-mcp

许可证

该项目遵循 MIT 开源许可条款。