Repology Mcp Server

io.github.tschoonj由 GitHub 帳號 tschoonj 發布v0.1.1更新於 Oct 24, 2026

MCP server that provides access to Repology package repository data

已驗證STDIO僅桌面開發者工具資料與分析

概覽

AI 產生的概覽

讓助理查詢 Repology 軟體套件倉庫資料，包括專案詳情、倉庫清單以及已回報的打包問題。

可以做什麼
透過五個唯讀工具存取 Repology 軟體套件資料：search_projects 依名稱子字串搜尋專案，get_project 回傳單一專案的詳細套件資訊，list_projects 可依維護者、類別以及倉庫存在與否等條件篩選並列出專案。另外兩個工具 get_repository_problems 與 get_maintainer_problems 分別回報某個倉庫或某位維護者套件的打包問題。
適用情境
適合需要查詢某個套件被哪些倉庫收錄、比較各發行版之間的版本，或查看打包問題與維護者問題的情境。它面向打包、發行版與相依性研究，而非一般網頁搜尋。
執行需求
以 stdio 方式在本機執行。安裝 PyPI 套件 repology-mcp-server（例如使用 uv 或 pip），或執行已發佈的容器映像。未宣告任何帳號、API 金鑰或環境變數；依其提供的資料，需要能連線至 Repology 的網路。
安裝前請注意
這些工具為唯讀，且不要求任何憑證，因此主要需考量對 Repology 的網路連線，以及第三方套件資料的準確性與時效性。維護者篩選需要電子郵件地址，該地址會傳送至上游服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Repology Mcp Server，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Repology MCP Server

[CI] [Docker] [Docker Image] [PyPI] [License: MIT]

A Model Context Protocol (MCP) server that provides access to the Repology package repository data through a standardized interface.

Features

This MCP server exposes the following tools:

  • search_projects: Search for projects by name
  • get_project: Get detailed information about a specific project
  • list_projects: List projects with optional filtering
  • get_repository_problems: Get problems reported for repositories
  • get_maintainer_problems: Get problems reported for specific maintainers

Installation

Using uv (recommended)

bash
# Install dependenciesuv sync
# Install in development modeuv pip install -e .

Using pip

bash
pip install -e .

Usage

As a standalone server

bash
# Run with stdio transport (for Claude Desktop, etc.)repology-mcp-server
# Run with HTTP transportrepology-mcp-server --transport http --port 8000

With Claude Desktop

Add to your Claude Desktop configuration:

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

Or using the pre-built Docker image:

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

With VS Code

Add to your VS Code settings (.vscode/settings.json or user settings):

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

Or using the pre-built Docker image:

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

As a development server

bash
# Run in development mode with MCP inspectoruv run mcp dev src/repology_mcp/server.py

Using Docker

Pre-built images from GitHub Container Registry
bash
# Pull the latest imagedocker pull ghcr.io/tschoonj/repology-mcp-server:latest
# Run with stdio transportdocker run -i --rm ghcr.io/tschoonj/repology-mcp-server:latest
# Run with HTTP transport on port 8000docker run --rm -p 8000:8000 ghcr.io/tschoonj/repology-mcp-server:latest --transport http --port 8000
# Use a specific versiondocker pull ghcr.io/tschoonj/repology-mcp-server:1.0.0docker run -i --rm ghcr.io/tschoonj/repology-mcp-server:1.0.0
Local development with Docker
bash
# Build the Docker image locallydocker build -t repology-mcp-server .
# Run with stdio transportdocker run -i --rm repology-mcp-server
# Run with HTTP transport on port 8000docker run --rm -p 8000:8000 repology-mcp-server --transport http --port 8000

Development

Setup

bash
# Clone the repositorygit clone <repository-url>cd repology-mcp-server
# Install development dependenciesuv sync --extra dev

Running tests

bash
# Run all testsuv run pytest
# Run with coverageuv run pytest --cov=repology_mcp --cov-report=html
# Run specific test fileuv run pytest tests/test_client.py -v

Code formatting

bash
# Format codeuv run black src testsuv run isort src tests
# Type checkinguv run mypy src

API Reference

Tools

search_projects

Search for projects by name substring.

Parameters:

  • query (string): Search term to match against project names
  • limit (integer, optional): Maximum number of results (default: 10, max: 100)
get_project

Get detailed package information for a specific project.

Parameters:

  • project_name (string): Exact name of the project to retrieve
list_projects

List projects with optional filtering.

Parameters:

  • start_from (string, optional): Project name to start listing from
  • limit (integer, optional): Maximum number of results (default: 10, max: 200)
  • maintainer (string, optional): Filter by maintainer email
  • category (string, optional): Filter by category
  • inrepo (string, optional): Filter by repository presence
  • notinrepo (string, optional): Filter by repository absence
get_repository_problems

Get problems reported for a specific repository.

Parameters:

  • repository (string): Repository name (e.g., "freebsd", "debian")
  • start_from (string, optional): Project name to start from for pagination
get_maintainer_problems

Get problems reported for packages maintained by a specific person.

Parameters:

  • maintainer (string): Maintainer email address
  • repository (string, optional): Limit to specific repository
  • start_from (string, optional): Project name to start from for pagination

License

MIT License - see LICENSE file for details.

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests for new functionality
  5. Run the test suite
  6. Submit a pull request

來源：README.md，提交 f8b0700

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分