Gke Hub Api

🚀 MCP 服务器

本项目是一个 MCP（模型上下文协议）服务器，针对给定的 OpenAPI URL - https://api.apis.guru/v2/specs/googleapis.com/gkehub/v1beta1/openapi.json 而构建，使用 AG2 的 MCP 构建器自动生成。

🚀 快速开始

本 MCP 服务器可助力你基于特定的 OpenAPI URL 开展相关工作，下面将为你介绍详细的安装、开发、运行等步骤。

✨ 主要特性

• 基于指定的 OpenAPI URL 自动生成 MCP 服务器。
• 支持多种传输模式，如 stdio、sse、streamable-http。
• 可通过环境变量灵活配置服务器。

📦 安装指南

前提条件

• Python 3.9+
• pip 和 uv

安装步骤

1. 克隆仓库：

git clone <repository-url>
cd mcp-server

2. 安装依赖： .devcontainer/setup.sh 脚本会使用 pip install -e ".[dev]" 来安装依赖。如果你不使用开发容器，可以手动运行此命令。

pip install -e ".[dev]"

或者，你也可以使用 uv：

uv pip install --editable ".[dev]"

💻 使用示例

基础用法

开发相关操作

• 代码检查与格式化：

ruff check

ruff format

这些命令也可通过 scripts/lint.sh 脚本执行。

• 静态分析：

./scripts/static-analysis.sh

此脚本也在 .pre-commit-config.yaml 中配置为预提交钩子。

• 运行测试：

./scripts/test.sh

这将运行 pytest 并生成覆盖率报告。若要生成合并报告并清理，可使用：

./scripts/test-cov.sh

• 安装预提交钩子：

pre-commit install

钩子会在每次提交前自动运行。

运行服务器

python mcp_server/main.py stdio

服务器可以使用环境变量进行配置：

• CONFIG_PATH：JSON 配置文件的路径（例如 mcp_server/mcp_config.json）。
• CONFIG：包含配置的 JSON 字符串。
• SECURITY：用于安全参数的环境变量（例如 API 密钥）。 具体加载方式可参考 mcp_server/main.py 中的 if __name__ == "__main__": 块。

构建与发布

hatch build

hatch publish

这些命令也可通过 scripts/publish.sh 脚本执行。

高级用法

在 tests/test_mcp_server.py 文件中展示了如何以编程方式启动和与服务器进行交互以进行测试。你可以根据实际需求对其进行扩展和修改，以满足不同的测试场景。