Pub.dev MCP Server

Dart 和 Flutter 官方包仓库 pub.dev 的一个 模型上下文协议 (MCP) 服务器。它允许AI助手搜索、分析并检索关于 Dart/Flutter 包的详细信息。

<a href="https://glama.ai/mcp/servers/@devqxi/pubdev-mcp-server"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=1516107830,1243941327&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Pub.dev Server MCP server" /> </a>

---

✨ 特性

• 🔍 包搜索 – 高级过滤与排序
• 📦 包信息 – 元数据、依赖项、统计信息
• 🔄 版本管理 – 检查更新、比较版本、跟踪历史
• 📚 文档访问 – 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

---

🛠 可用工具

工具	描述	关键参数
get_package_info	获取包元数据、统计信息、依赖项、发布者	packageName
search_packages	使用过滤器和排序进行搜索	query, sort, page
check_package_updates	检查是否有可用更新	packageName, currentVersion
get_package_versions	获取版本历史	packageName, limit
get_documentation_changes	获取 README、变更日志、示例、API 文档	packageName, version, docType
compare_package_versions	比较不同版本之间的依赖项及变化	packageName, fromVersion, toVersion

---

📖 示例命令

• 搜索包
  “按受欢迎程度排序搜索状态管理包”

• 包详情
  “获取 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 Inspector 测试：

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 '添加功能' && git push)
5. 打开 Pull Request

---

📜 许可证

MIT – 查看 LICENSE

---

📢 支持

• GitHub Issues
• Wiki
• 讨论

---

🆕 更新日志

v1.0.0

• 初始发布
• 支持所有主要 pub.dev API 端点
• 实现缓存和错误处理
• 完全符合 MCP 协议