Repology MCP Server

🚀 Repology MCP Server

このModel Context Protocol (MCP)サーバーは、標準化されたインターフェースを通じてRepologyパッケージリポジトリデータへのアクセスを提供します。

🚀 クイックスタート

このセクションでは、Repology MCP Serverの基本的な使い方や起動方法について説明します。

✨ 主な機能

この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. プルリクエストを送信します。