Pubdev MCP Server

🚀 Pub.dev MCP 服務器

這是一個為 pub.dev（Dart 和 Flutter 的官方包倉庫）打造的 模型上下文協議（Model Context Protocol，MCP） 服務器。它能讓 AI 助手對 Dart/Flutter 包進行 搜索、分析 並 獲取 詳細信息。

🚀 快速開始

本服務器允許 AI 助手對 Dart/Flutter 包執行搜索、分析和信息檢索操作。你可以按照以下步驟進行安裝和配置。

✨ 主要特性

• 🔍 包搜索：支持高級過濾和排序功能。
• 📦 包信息：可獲取元數據、依賴項和統計信息。
• 🔄 版本管理：能檢查更新、比較版本並跟蹤版本歷史。
• 📚 文檔訪問：可訪問 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 桌面端

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 桌面端。

本地構建示例：

{
  "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 問題
• Wiki
• 討論區

🆕 更新日誌

v1.0.0

• 初始版本發佈。
• 支持所有主要的 pub.dev API 端點。
• 實現緩存和錯誤處理功能。
• 完全符合 MCP 協議。