docs-mcp

Claude Code does not support MCP server names with spaces. Failing $ claude mcp add --transport http "Astro docs" https://mcp.docs.astro.build/mcp Invalid name Astro docs. Names can only contain letters, numbers, hyphens, and underscores. Working $ claude mcp add --transport http "Astro-Docs" https://mcp.docs.astro.build/mcp Added HTTP MCP server Astro-Docs with URL: https://mcp.docs.astro.build/mcp to local config File modified: /Users/allistera/.claude.json [project: /Users/allistera]

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 () into one plugin. This would give Claude Code users: Access to the latest Astro docs via MCP Code intelligence for files via LSP The end result is that Claude Code users would be able to set up everything with two commands: This replaces the current manual setup of running , while providing more functionality. Additionally, plugin installations are tracked in the project’s under . 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 If this looks like a good idea, I can open a pull request.

The server at mcp.docs.astro.build has an expired TLS certificate, CloudFront distribution needs a cert renewal.