Repology MCP Server

🚀 Repology MCP Server

Repology MCP Server 是一個模型上下文協議（MCP）服務器，它通過標準化接口提供對 Repology 軟件包倉庫數據的訪問，方便用戶搜索和獲取項目信息。

✨ 主要特性

此 MCP 服務器提供了以下工具：

• search_projects：按名稱搜索項目
• get_project：獲取特定項目的詳細信息
• list_projects：列出項目，支持可選過濾
• get_repository_problems：獲取倉庫報告的問題
• get_maintainer_problems：獲取特定維護者報告的問題

📦 安裝指南

使用 uv（推薦）

# 安裝依賴
uv sync

# 以開發模式安裝
uv pip install -e .

使用 pip

pip install -e .

💻 使用示例

作為獨立服務器運行

# 使用 stdio 傳輸運行（適用於 Claude Desktop 等）
repology-mcp-server

# 使用 HTTP 傳輸運行
repology-mcp-server --transport http --port 8000

與 Claude Desktop 配合使用

添加到你的 Claude Desktop 配置中：

{
  "mcpServers": {
    "repology": {
      "command": "uv",
      "args": ["run", "repology-mcp-server"]
    }
  }
}

或者使用預構建的 Docker 鏡像：

{
  "mcpServers": {
    "repology": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/tschoonj/repology-mcp-server:latest"]
    }
  }
}

與 VS Code 配合使用

添加到你的 VS Code 設置（.vscode/settings.json 或用戶設置）中：

{
  "mcp.servers": {
    "repology": {
      "command": "uv",
      "args": ["run", "repology-mcp-server"]
    }
  }
}

或者使用預構建的 Docker 鏡像：

{
  "mcp.servers": {
    "repology": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/tschoonj/repology-mcp-server:latest"]
    }
  }
}

作為開發服務器運行

# 在開發模式下使用 MCP 檢查器運行
uv run mcp dev src/repology_mcp/server.py

使用 Docker

從 GitHub Container Registry 獲取預構建鏡像

# 拉取最新鏡像
docker pull ghcr.io/tschoonj/repology-mcp-server:latest

# 使用 stdio 傳輸運行
docker run -i --rm ghcr.io/tschoonj/repology-mcp-server:latest

# 在端口 8000 上使用 HTTP 傳輸運行
docker run --rm -p 8000:8000 ghcr.io/tschoonj/repology-mcp-server:latest --transport http --port 8000

# 使用特定版本
docker pull ghcr.io/tschoonj/repology-mcp-server:1.0.0
docker run -i --rm ghcr.io/tschoonj/repology-mcp-server:1.0.0

在本地使用 Docker 進行開發

# 在本地構建 Docker 鏡像
docker build -t repology-mcp-server .

# 使用 stdio 傳輸運行
docker run -i --rm repology-mcp-server

# 在端口 8000 上使用 HTTP 傳輸運行
docker run --rm -p 8000:8000 repology-mcp-server --transport http --port 8000

📚 詳細文檔

開發設置

# 克隆倉庫
git clone <repository-url>
cd repology-mcp-server

# 安裝開發依賴
uv sync --extra dev

運行測試

# 運行所有測試
uv run pytest

# 運行測試並生成覆蓋率報告
uv run pytest --cov=repology_mcp --cov-report=html

# 運行特定測試文件
uv run pytest tests/test_client.py -v

代碼格式化

# 格式化代碼
uv run black src tests
uv run isort src tests

# 類型檢查
uv run mypy src

📄 API 文檔

工具

search_projects

按名稱子字符串搜索項目。

參數：

• query（字符串）：用於匹配項目名稱的搜索詞
• limit（整數，可選）：最大結果數（默認：10，最大：100）

get_project

獲取特定項目的詳細軟件包信息。

參數：

• project_name（字符串）：要檢索的項目的確切名稱

list_projects

列出項目，支持可選過濾。

參數：

• start_from（字符串，可選）：開始列出項目的名稱
• limit（整數，可選）：最大結果數（默認：10，最大：200）
• maintainer（字符串，可選）：按維護者電子郵件過濾
• category（字符串，可選）：按類別過濾
• inrepo（字符串，可選）：按倉庫存在情況過濾
• notinrepo（字符串，可選）：按倉庫不存在情況過濾

get_repository_problems

獲取特定倉庫報告的問題。

參數：

• repository（字符串）：倉庫名稱（例如，"freebsd"，"debian"）
• start_from（字符串，可選）：用於分頁的起始項目名稱

get_maintainer_problems

獲取特定人員維護的軟件包報告的問題。

參數：

• maintainer（字符串）：維護者電子郵件地址
• repository（字符串，可選）：限制到特定倉庫
• start_from（字符串，可選）：用於分頁的起始項目名稱

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。

貢獻指南

1. 分叉倉庫
2. 創建功能分支
3. 進行更改
4. 為新功能添加測試
5. 運行測試套件
6. 提交拉取請求