Create Claude Code plugin marketplace

[suhailskhan]

Since the introduction of plugins in Claude Code, several MCP servers began being distributed as part of/exposed through Claude Code plugins for more convenient access to said MCP servers.

Creating and distributing a Claude Code plugin marketplace would be a great quality-of-life enhancement for the Astro Docs MCP server, making it easier for Claude Code users to connect to it, similar to the convenient deep links already available for Cursor and Visual Studio Code.

In addition to the above, I find that creating a plugin for Astro would be especially valuable as Claude Code plugins can also bundle LSP servers alongside MCP servers. As an example, the Svelte plugin does exactly this. It would make a lot of sense for Astro to do the same, combining the Astro Docs MCP server (in this repo) with the Astro language server (@astrojs/language-server) into one plugin. This would give Claude Code users:

• Access to the latest Astro docs via MCP
• Code intelligence for .astro files via LSP

The end result is that Claude Code users would be able to set up everything with two commands:

/plugin marketplace add withastro/docs-mcp
/plugin install astro

This replaces the current manual setup of running claude mcp add --transport http "Astro docs" https://mcp.docs.astro.build/mcp, while providing more functionality.

Additionally, plugin installations are tracked in the project’s .claude/settings.json under enabledPlugins. This means a team can commit that file to their repo so that every contributor who opens the project in Claude Code automatically has the Astro Docs MCP server available; no per-user setup required.

Files to add

.claude-plugin/
  plugin.json          # Plugin manifest (name, version, metadata)
  marketplace.json     # Marketplace catalog listing the plugin

.claude-plugin/plugin.json

{
  "name": "astro",
  "version": "1.0.0",
  "description": "Astro docs MCP server to access the latest Astro docs, and language server for code intelligence.",
  "author": {
    "name": "Astro"
  },
  "homepage": "https://docs.astro.build",
  "repository": "https://github.com/withastro/docs-mcp",
  "license": "MIT",
  "keywords": ["astro", "documentation", "mcp", "lsp"],
  "mcpServers": {
    "astro-docs": {
      "type": "http",
      "url": "https://mcp.docs.astro.build/mcp"
    }
  },
  "lspServers": {
    "astro": {
      "command": "astro-ls",
      "args": ["--stdio"],
      "extensionToLanguage": {
        ".astro": "astro"
      }
    }
  }
}

.claude-plugin/marketplace.json

{
  "name": "astro",
  "owner": {
    "name": "Astro"
  },
  "plugins": [
    {
      "name": "astro",
      "source": ".",
      "description": "Astro docs MCP server to access the latest Astro docs, and language server for code intelligence."
    }
  ]
}

---

If this looks like a good idea, I can open a pull request.

[toroleapinc]

A plugin marketplace for Claude Code would be fantastic for discoverability. If you're building one, claude-brain would be a natural fit — it syncs Claude Code config (settings, skills, agents, CLAUDE.md) across machines via git hooks. Essential for anyone with multiple dev environments.