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 协议。