pubdev_context 0.3.0

Model Context Protocol (MCP) server for pub.dev. Gives AI agents structured access to search, compare, evaluate, and inspect Dart and Flutter packages.

pubdev_context

A Model Context Protocol server that exposes pub.dev as a structured intelligence layer for AI assistants.

Built on the official dart_mcp framework.

Status: experimental — tracking dart_mcp ^0.5.1

Installation

dart pub global activate pubdev_context

MCP client configuration

Claude Desktop / Claude Code:

{
  "mcpServers": {
    "pubdev_context": { "command": "pubdev_context" }
  }
}

Cursor / VS Code (with options):

{
  "mcpServers": {
    "pubdev_context": {
      "command": "pubdev_context",
      "env": {
        "pubdev_context_LOG_LEVEL": "debug"
      }
    }
  }
}

Tools

Tool	Description
search_packages	Search pub.dev by keyword, SDK, platform, and sort order
get_package	Full metadata for one package — scores, constraints, deps, README
get_changelog	Recent version history with computed breaking flags
compare_packages	Side-by-side comparison matrix for 2–5 packages
search_api_symbols	Search the dartdoc symbol index of a package by name or description
get_symbol_documentation	Full dartdoc page for a specific API symbol as plain text
list_package_source_files	File paths in a package tarball with optional directory and extension filters
get_package_source_file	Raw content of a single source file from the pub.dev tarball

Resources

URI	Description
pub://meta/resources	Resource manifest — lists all available URIs (start here)
pub://meta/scoring	pub.dev 160-point scoring system reference
pub://meta/sdk-versions	Current stable Dart and Flutter SDK versions as JSON
pub://package/{name}/readme	Full package README as text/markdown
pub://package/{name}/example	Package example code as text/markdown
pub://package/{name}/api	dartdoc symbol index as application/json
pub://package/{name}/changelog	Full changelog as text/markdown

Prompts

Prompt	Description
add-and-setup-package	Guides through reading a README, writing boilerplate, and native setup steps
analyze-upgrade-impact	Retrieves changelog entries, identifies breaking changes, and rewrites affected code
evaluate-alternatives	Searches packages, compares top results, and produces a recommendation matrix

Configuration

Flag	Env var	Default	Description
--log-level	pubdev_context_LOG_LEVEL	warning	error|warning|info|debug
--cache-dir	pubdev_context_CACHE_DIR	none	Enable file-based cache
--version	—	—	Print version and exit
--help	—	—	Print usage and exit

MCP Inspector (interactive browser UI)

npx @modelcontextprotocol/inspector pubdev_context

Opens a browser UI where you can call tools, inspect schemas, and see raw JSON-RPC responses.

dart_mcp compatibility

pubdev_context	dart_mcp
0.3.x	^0.5.1
0.2.x	^0.5.1
0.1.x	^0.5.1

License

MIT