Pubdev MCP Server

🚀 Pub.dev MCP Server

pub.dev（DartとFlutterの公式パッケージリポジトリ）用のModel Context Protocol (MCP) サーバーです。
このサーバーにより、AIアシスタントはDart/Flutterパッケージに関する詳細情報を検索、分析、取得することができます。

🚀 クイックスタート

このサーバーは、pub.dev上のDart/Flutterパッケージに関する情報をAIアシスタントが取得できるようにするためのものです。以下のセクションでは、インストール方法や使用方法などの詳細を説明します。

✨ 主な機能

• 🔍 パッケージ検索 – 高度なフィルタリングとソート機能
• 📦 パッケージ情報 – メタデータ、依存関係、統計情報
• 🔄 バージョン管理 – 更新の確認、バージョンの比較、履歴の追跡
• 📚 ドキュメントアクセス – README、変更履歴、サンプルコード、APIドキュメント
• ⚡ キャッシュ機能 – 組み込みの5分間のインテリジェントキャッシュ
• 🛠 依存関係分析 – バージョン間の依存関係の比較

📦 インストール

NPM（推奨）

npm install -g @devqxi/pubdev-mcp-server

ソースからのインストール

git clone https://github.com/devqxi/pubdev-mcp-server.git
cd pubdev-mcp-server
npm install
npm run build
npm run start

⚙️ 設定

Claude Desktop

1. 設定ファイルの場所を特定します。

   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. 以下を追加します。

{
  "mcpServers": {
    "pubdev": {
      "command": "npx",
      "args": ["@devqxi/pubdev-mcp-server"]
    }
  }
}

3. Claude Desktopを再起動します。

ローカルビルドの例:

{
  "mcpServers": {
    "pubdev": {
      "command": "node",
      "args": ["/path/to/pubdev-mcp-server/dist/pubdev-mcp.js"]
    }
  }
}

その他のMCPクライアント:

npx @devqxi/pubdev-mcp-server

🛠 利用可能なツール

📖 コマンド例

• パッケージの検索
  "人気順に並べられた状態管理パッケージを検索する"

• パッケージの詳細情報
  "flutter_blocパッケージに関する情報を取得する"

• 更新の確認
  "providerパッケージがバージョン6.0.0から更新されているかどうかを確認する"

• ドキュメントの取得
  "dioバージョン4.0.0の変更履歴を取得する"

• バージョンの比較
  "httpパッケージのバージョン2.0.0と3.0.0間の依存関係を比較する"

💻 開発

git clone https://github.com/devqxi/pubdev-mcp-server.git
cd pubdev-mcp-server
npm install
npm run build
npm run start

MCPインスペクターでテストする:

npx @modelcontextprotocol/inspector npx @devqxi/pubdev-mcp-server

🌐 APIリファレンス

• https://pub.dev/api/packages/{package}
• https://pub.dev/api/search
• https://pub.dev/api/packages/{package}/versions
• https://pub.dev/packages/{package}/{version}/{doc-type}

🛡 エラーハンドリング

• ネットワークとAPIのエラーを適切に処理します。
• 無効または存在しないパッケージに対して明確なエラーを表示します。
• 礼儀正しいレート制限のために組み込みの遅延を設定します。
• 不正なリクエストに対して詳細な検証メッセージを表示します。

🤝 コントリビューション

1. フォークしてブランチを作成します (git checkout -b feature/amazing-feature)。
2. 依存関係をインストールします (npm install)。
3. ビルドとテストを実行します (npm run build && npm test)。
4. コミットしてプッシュします (git commit -m 'Add feature' && git push)。
5. プルリクエストを作成します。

📜 ライセンス

MIT – LICENSE を参照してください。

📢 サポート

• GitHub Issues
• Wiki
• Discussions

🆕 変更履歴

v1.0.0

• 初回リリース
• すべての主要なpub.dev APIエンドポイントをサポート
• キャッシュとエラーハンドリングを実装
• 完全なMCPプロトコル準拠