repology-mcp-server

Repology MCP 服务

一个模型上下文协议（MCP）服务，通过标准化接口提供对 Repology 软件包仓库数据的访问。

功能

此 MCP 服务提供以下工具：

• search_projects：按名称搜索项目
• get_project：获取特定项目的详细信息
• list_projects：列出项目，可选择筛选条件
• get_repository_problems：获取仓库报告的问题
• get_maintainer_problems：获取特定维护者报告的问题

安装

使用 uv（推荐）

# Install dependencies
uv sync

# Install in development mode
uv pip install -e .

使用 pip

pip install -e .

使用方法

作为独立服务运行

# Run with stdio transport (for Claude Desktop, etc.)
repology-mcp-server

# Run with HTTP transport
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"]
    }
  }
}

作为开发服务运行

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

使用 Docker

使用 GitHub Container Registry 中的预构建镜像

# Pull the latest image
docker pull ghcr.io/tschoonj/repology-mcp-server:latest

# Run with stdio transport
docker run -i --rm ghcr.io/tschoonj/repology-mcp-server:latest

# Run with HTTP transport on port 8000
docker run --rm -p 8000:8000 ghcr.io/tschoonj/repology-mcp-server:latest --transport http --port 8000

# Use a specific version
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 进行本地开发

# Build the Docker image locally
docker build -t repology-mcp-server .

# Run with stdio transport
docker run -i --rm repology-mcp-server

# Run with HTTP transport on port 8000
docker run --rm -p 8000:8000 repology-mcp-server --transport http --port 8000

开发

设置

# Clone the repository
git clone <repository-url>
cd repology-mcp-server

# Install development dependencies
uv sync --extra dev

运行测试

# Run all tests
uv run pytest

# Run with coverage
uv run pytest --cov=repology_mcp --cov-report=html

# Run specific test file
uv run pytest tests/test_client.py -v

代码格式化

# Format code
uv run black src tests
uv run isort src tests

# Type checking
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. Fork 此仓库
2. 创建功能分支
3. 进行修改
4. 为新功能添加测试
5. 运行测试套件
6. 提交拉取请求