Dart/Flutter包管理服务器

一个用于pub.dev的模型上下文协议(MCP)服务器,提供Dart/Flutter包的搜索、分析和信息检索功能。

  • by devqxi
  • JavaScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 devqxi/pubdev-mcp-server

使用说明

Pub.dev MCP服务器

A. 模型上下文协议(MCP) 服务器 pub.dev,Dart和Flutter的官方软件包存储库。
它允许AI助手 搜索, 分析,以及 检索 Dart/Flutter软件包的详细信息。


✨ 特性

  • 🔍 程序包搜索 –高级过滤和排序
  • 📦 包裹信息 –元数据、依赖关系、统计数据
  • 🔄 版本管理 –检查更新、比较版本、跟踪历史记录
  • 📚 文档访问 –自述文件、变更日志、示例、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

⚙️ 配置

克劳德桌面

  1. 找到您的配置文件:

    • 视窗: %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"]
    }
  }
}
  1. 重新启动克劳德桌面。

本地构建示例:

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

其他MCP客户端:

npx @devqxi/pubdev-mcp-server

🛠 可用工具

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

📖 示例命令

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

  • 包裹详细信息
    “获取有关flutter_bloc包的信息”

  • 检查更新
    “检查提供程序是否有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. 安装deps(npm install)
  3. 构建和测试(npm run build && npm test)
  4. 承诺与推动(git commit -m 'Add feature' && git push)
  5. 打开拉取请求

📜 许可证

麻省理工学院-参见 许可证


📢 支持


🆕 更新日志

v1.0.0

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