{"_rev":"4-2a32fe4ff10913d9af56c4e2c478be96","time":{"created":"2025-08-11T10:53:04.559Z","modified":"2025-08-11T10:53:05.052Z","1.0.0":"2025-08-11T10:31:23.254Z","1.0.1":"2025-08-11T10:53:04.807Z"},"_id":"@devqxi/pubdev-mcp-server","name":"@devqxi/pubdev-mcp-server","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.1":{"name":"@devqxi/pubdev-mcp-server","version":"1.0.1","description":"Model Context Protocol server for pub.dev - Access Dart and Flutter package information, search, version management, and documentation","type":"module","main":"dist/pubdev-mcp.js","bin":{"pubdev-mcp-server":"dist/pubdev-mcp.js"},"scripts":{"build":"tsc","start":"node dist/pubdev-mcp.js","dev":"tsc && node dist/pubdev-mcp.js","prepublishOnly":"npm run build","test":"node test/quick-test.js"},"keywords":["mcp","model-context-protocol","pub.dev","dart","flutter","package-manager","api","claude","ai-tools"],"author":{"name":"devqxi","url":"https://github.com/devqxi"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/devqxi/pubdev-mcp-server.git"},"bugs":{"url":"https://github.com/devqxi/pubdev-mcp-server/issues"},"homepage":"https://github.com/devqxi/pubdev-mcp-server#readme","dependencies":{"@modelcontextprotocol/sdk":"^0.5.0","node-fetch":"^3.3.2"},"devDependencies":{"@types/node":"^20.10.0","typescript":"^5.3.0"},"engines":{"node":">=18.0.0"},"publishConfig":{"access":"public"},"_id":"@devqxi/pubdev-mcp-server@1.0.1","gitHead":"a0923445aadc57e0c384d6e83384cae0dee2e129","types":"./dist/pubdev-mcp.d.ts","_nodeVersion":"24.4.1","_npmVersion":"11.4.2","dist":{"integrity":"sha512-mWIQGinWTS971zKhyE4X4wMjHK1VuMWq7cb+UvvOX8zsLvuYEeU71n1S/jnfnmf2ZtiprWzIDYUT6zCoXMNlLQ==","shasum":"0ae5f3064d825add9b8c9bf680cdb5d7ccde90db","tarball":"https://registry.npmjs.org/@devqxi/pubdev-mcp-server/-/pubdev-mcp-server-1.0.1.tgz","fileCount":5,"unpackedSize":27568,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCZRvctXU5d4kj42DZk6ms+Y8qiMZwqsG7GdVNmuW/oIQIgdlu/erSpu6NmM2GmunMdcTSOsc8yi/qKP5LMLqsEBeQ="}]},"_npmUser":{"name":"zakblack","email":"benaissa.ishaq@gmail.com"},"directories":{},"maintainers":[{"name":"zakblack","email":"benaissa.ishaq@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/pubdev-mcp-server_1.0.1_1754909584635_0.08432862383657458"},"_hasShrinkwrap":false}},"maintainers":[{"name":"zakblack","email":"benaissa.ishaq@gmail.com"}],"description":"Model Context Protocol server for pub.dev - Access Dart and Flutter package information, search, version management, and documentation","homepage":"https://github.com/devqxi/pubdev-mcp-server#readme","keywords":["mcp","model-context-protocol","pub.dev","dart","flutter","package-manager","api","claude","ai-tools"],"repository":{"type":"git","url":"git+https://github.com/devqxi/pubdev-mcp-server.git"},"author":{"name":"devqxi","url":"https://github.com/devqxi"},"bugs":{"url":"https://github.com/devqxi/pubdev-mcp-server/issues"},"license":"MIT","readme":"# Pub.dev MCP Server\r\n\r\nA **Model Context Protocol (MCP)** server for [pub.dev](https://pub.dev), the official package repository for Dart and Flutter.  \r\nIt allows AI assistants to **search**, **analyze**, and **retrieve** detailed information about Dart/Flutter packages.\r\n\r\n---\r\n\r\n## ✨ Features\r\n- 🔍 **Package Search** – Advanced filtering & sorting  \r\n- 📦 **Package Information** – Metadata, dependencies, statistics  \r\n- 🔄 **Version Management** – Check updates, compare versions, track history  \r\n- 📚 **Documentation Access** – README, changelog, examples, API docs  \r\n- ⚡ **Caching** – Built-in 5-minute intelligent cache  \r\n- 🛠 **Dependency Analysis** – Compare dependencies between versions  \r\n\r\n---\r\n\r\n## 📦 Installation\r\n\r\n### NPM (Recommended)\r\n```bash\r\nnpm install -g @devqxi/pubdev-mcp-server\r\n```\r\n\r\n### From Source\r\n```bash\r\ngit clone https://github.com/devqxi/pubdev-mcp-server.git\r\ncd pubdev-mcp-server\r\nnpm install\r\nnpm run build\r\nnpm run start\r\n```\r\n\r\n---\r\n\r\n## ⚙️ Configuration\r\n\r\n### Claude Desktop\r\n1. Locate your configuration file:  \r\n   - **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`  \r\n   - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  \r\n   - **Linux**: `~/.config/Claude/claude_desktop_config.json`\r\n\r\n2. Add:\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"pubdev\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"@devqxi/pubdev-mcp-server\"]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n3. Restart Claude Desktop.\r\n\r\n**Local Build Example**:\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"pubdev\": {\r\n      \"command\": \"node\",\r\n      \"args\": [\"/path/to/pubdev-mcp-server/dist/pubdev-mcp.js\"]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n**Other MCP Clients**:\r\n```bash\r\nnpx @devqxi/pubdev-mcp-server\r\n```\r\n\r\n---\r\n\r\n## 🛠 Available Tools\r\n\r\n| Tool | Description | Key Parameters |\r\n|------|-------------|----------------|\r\n| **get_package_info** | Retrieve package metadata, stats, dependencies, publishers | `packageName` |\r\n| **search_packages** | Search with filters and sorting | `query`, `sort`, `page` |\r\n| **check_package_updates** | Check if updates are available | `packageName`, `currentVersion` |\r\n| **get_package_versions** | Get version history | `packageName`, `limit` |\r\n| **get_documentation_changes** | Get README, changelog, examples, API docs | `packageName`, `version`, `docType` |\r\n| **compare_package_versions** | Compare dependencies & changes between versions | `packageName`, `fromVersion`, `toVersion` |\r\n\r\n---\r\n\r\n## 📖 Example Commands\r\n\r\n- **Search Packages**  \r\n  _\"Search for state management packages sorted by popularity\"_\r\n\r\n- **Package Details**  \r\n  _\"Get information about the flutter_bloc package\"_\r\n\r\n- **Check Updates**  \r\n  _\"Check if provider has updates from version 6.0.0\"_\r\n\r\n- **Get Docs**  \r\n  _\"Get the changelog for dio version 4.0.0\"_\r\n\r\n- **Compare Versions**  \r\n  _\"Compare dependencies between http 2.0.0 and 3.0.0\"_\r\n\r\n---\r\n\r\n## 💻 Development\r\n\r\n```bash\r\ngit clone https://github.com/devqxi/pubdev-mcp-server.git\r\ncd pubdev-mcp-server\r\nnpm install\r\nnpm run build\r\nnpm run start\r\n```\r\n\r\n**Test with MCP Inspector**:\r\n```bash\r\nnpx @modelcontextprotocol/inspector npx @devqxi/pubdev-mcp-server\r\n```\r\n\r\n---\r\n\r\n## 🌐 API Reference\r\n- `https://pub.dev/api/packages/{package}`\r\n- `https://pub.dev/api/search`\r\n- `https://pub.dev/api/packages/{package}/versions`\r\n- `https://pub.dev/packages/{package}/{version}/{doc-type}`\r\n\r\n---\r\n\r\n## 🛡 Error Handling\r\n- Graceful handling of network & API failures  \r\n- Clear errors for invalid/non-existent packages  \r\n- Built-in delays for respectful rate limiting  \r\n- Detailed validation messages for malformed requests  \r\n\r\n---\r\n\r\n## 🤝 Contributing\r\n1. Fork & branch (`git checkout -b feature/amazing-feature`)  \r\n2. Install deps (`npm install`)  \r\n3. Build & test (`npm run build && npm test`)  \r\n4. Commit & push (`git commit -m 'Add feature' && git push`)  \r\n5. Open a Pull Request  \r\n\r\n---\r\n\r\n## 📜 License\r\nMIT – See [LICENSE](LICENSE)\r\n\r\n---\r\n\r\n## 📢 Support\r\n- [GitHub Issues](https://github.com/devqxi/pubdev-mcp-server/issues)  \r\n- [Wiki](https://github.com/devqxi/pubdev-mcp-server/wiki)  \r\n- [Discussions](https://github.com/devqxi/pubdev-mcp-server/discussions)  \r\n\r\n---\r\n\r\n## 🆕 Changelog\r\n**v1.0.0**\r\n- Initial release  \r\n- All major pub.dev API endpoints supported  \r\n- Caching & error handling implemented  \r\n- Full MCP protocol compliance  \r\n","readmeFilename":"README.md"}