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. 提交拉取请求