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 文件中展示瞭如何以編程方式啟動和與服務器進行交互以進行測試。你可以根據實際需求對其進行擴展和修改，以滿足不同的測試場景。