feat(astro): add Astro Docs MCP plugin by amondnet · Pull Request #232 · pleaseai/claude-code-plugins

amondnet · 2026-06-24T11:48:45Z

Summary

Adds a new Astro Docs MCP plugin (MCP-only, no slash commands or skills) to the marketplace. The plugin wraps the official Astro Docs streamable-HTTP MCP server at https://mcp.docs.astro.build/mcp, giving Claude Code access to up-to-date Astro documentation via MCP.

Changes

plugins/astro/ — new plugin directory with five generated manifest files:
- .claude-plugin/plugin.json — Claude Code manifest (source of truth)
- .codex-plugin/plugin.json — Codex manifest (generated via multi-format)
- plugin.json — Antigravity root manifest (generated)
- .mcp.json — Codex MCP config (generated)
- mcp_config.json — Antigravity MCP config (generated)
.claude-plugin/marketplace.json — added astro entry (source of truth)
.agents/plugins/marketplace.json — regenerated Codex marketplace with astro entry
release-please-config.json — added plugins/astro package entry
.release-please-manifest.json — added "plugins/astro": "1.0.0"
README.md — added astro to Built-in Plugins list and install command

MCP Endpoint

The plugin uses the official Astro Docs MCP endpoint:

https://mcp.docs.astro.build/mcp

Transport: streamable-HTTP (no local process required).

Multi-runtime manifests

All runtime artifacts were generated by:

bun scripts/cli.ts multi-format

Claude Code manifest is the source of truth; Codex and Antigravity manifests are generated and should not be hand-edited.

Notes

bun.lock was intentionally excluded from this PR — it contains a pre-existing, unrelated change (plugins/gatekeeper 1.4.0 → 1.5.0) that will be committed separately.

Summary by cubic

Adds the MCP-only astro plugin to give up-to-date Astro docs access via the official Astro Docs MCP server. Includes marketplace wiring, generated manifests for all runtimes, release automation, and README updates.

New Features
- Adds plugins/astro wrapping the Astro Docs MCP server at https://mcp.docs.astro.build/mcp (streamable HTTP; no local process).
- Generates multi-runtime manifests (.claude-plugin/plugin.json, .codex-plugin/plugin.json, plugin.json, .mcp.json, mcp_config.json) and adds marketplace entries.
- Adds release automation entries and pins version to 1.0.0.
- Updates README with install command and source links.

^{Written for commit 8dd763f. Summary will update on new commits.}

Summary by CodeRabbit

New Features
- Added a new Astro plugin to the available plugin marketplace, making Astro documentation access easier to discover and install.
- Included the plugin in the install list with the astro install command.
Documentation
- Updated the plugin catalog and README to show Astro as an available option with its description and source link.

MCP-only plugin wrapping the Astro Docs streamable-HTTP MCP server (https://mcp.docs.astro.build/mcp). Multi-runtime manifests (Claude Code, Codex, Antigravity) generated via `bun scripts/cli.ts multi-format`. Includes marketplace entry in .claude-plugin/marketplace.json (source of truth), regenerated Codex marketplace at .agents/plugins/marketplace.json, release-please-config.json package entry, .release-please-manifest.json version pin at 1.0.0, and README wiring under Built-in Plugins.

vercel · 2026-06-24T11:48:51Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
claude-code-plugins	Ready	Preview, Comment	Jun 24, 2026 11:49am

coderabbitai · 2026-06-24T11:49:03Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: f8db28a7-b06e-400a-8541-2cbc8c52b8fc

📥 Commits

Reviewing files that changed from the base of the PR and between 52d3d31 and 8dd763f.

📒 Files selected for processing (10)

.agents/plugins/marketplace.json
.claude-plugin/marketplace.json
.release-please-manifest.json
README.md
plugins/astro/.claude-plugin/plugin.json
plugins/astro/.codex-plugin/plugin.json
plugins/astro/.mcp.json
plugins/astro/mcp_config.json
plugins/astro/plugin.json
release-please-config.json

📝 Walkthrough

Walkthrough

A new astro plugin is added to the repository. It defines MCP server manifests for both Claude and Codex plugin formats, pointing to https://mcp.docs.astro.build/mcp. The plugin is registered in both marketplace JSON files, versioned in release-please config, and documented in the README.

Changes

Astro Plugin Addition

Layer / File(s)	Summary
Astro plugin core manifests and MCP config `plugins/astro/plugin.json`, `plugins/astro/.claude-plugin/plugin.json`, `plugins/astro/.codex-plugin/plugin.json`, `plugins/astro/.mcp.json`, `plugins/astro/mcp_config.json`	Creates the plugin directory with top-level metadata manifest, per-client plugin.json files for Claude and Codex formats (including `mcpServers` registration and `defaultPrompt`), and two MCP server config files defining the `astro-docs` HTTP server at `https://mcp.docs.astro.build/mcp`.
Marketplace and release-please registration `.agents/plugins/marketplace.json`, `.claude-plugin/marketplace.json`, `.release-please-manifest.json`, `release-please-config.json`	Inserts the `astro` plugin entry into both marketplace manifests with its source path, policies, and category; adds `plugins/astro` at version `1.0.0` to the release manifest; and adds a release-please package block tracking `$.version` across the three plugin JSON files.
README documentation `README.md`	Adds the Astro plugin to the Available Plugins catalog with description, `/plugin install astro@pleaseai` command, and source link; also inserts the install command into the commands list.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~4 minutes

Possibly related PRs

pleaseai/claude-code-plugins#226: Adds a cloudflare plugin using the same file structure and marketplace registration pattern as this PR.
pleaseai/claude-code-plugins#230: Adds an asana plugin entry to .claude-plugin/marketplace.json using the same manifest structure.
pleaseai/claude-code-plugins#231: Also adds an asana plugin entry to the marketplace catalog in the same plugins array format.

Poem

🐇 Hop, hop, into the stars we go,
A new Astro plugin joins the show!
MCP server points to docs so bright,
plugin install astro — feels just right.
The marketplace grows, one framework more,
This bunny's delighted to the core! 🌟

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and concisely matches the main change: adding an Astro Docs MCP plugin.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch amondnet/astro

_{Comment @coderabbitai help to get the list of available commands.}

gemini-code-assist

Code Review

This pull request introduces a new Astro documentation plugin, adding the Astro Docs MCP server to the marketplace, updating configuration files, and adding documentation in the README. The review feedback correctly identifies that the MCP server transport protocol type in .claude-plugin/plugin.json should be changed from "http" to "sse" to ensure compatibility with the Server-Sent Events protocol used by the Astro Docs MCP server.

codacy-production · 2026-06-24T11:52:58Z

Up to standards ✅

🟢 Issues0 issues

Results:
0 new issues
View in Codacy

_{NEW Get contextual insights on your PRs based on Codacy's metrics, along with PR and Jira context, without leaving GitHub. Enable AI reviewer}
_{TIP This summary will be updated as you push new changes.}

cubic-dev-ai

No issues found across 10 files

Confidence score: 5/5

Automated review surfaced no issues in the provided summaries.
No files require special attention.

Architecture diagram

sequenceDiagram
participant User as User / Developer
participant Claude as Claude Code (Runtime)
participant PkgMgr as Plugin Manager
participant MCP as MCP Client
participant AstroMCP as Astro Docs MCP Server
Note over User,AstroMCP: NEW: Astro Docs MCP Plugin (MCP‑only, streamable‑HTTP)
User->>Claude: /plugin install astro@pleaseai
Claude->>PkgMgr: Resolve plugin from marketplace
PkgMgr->>PkgMgr: Read .claude-plugin/plugin.json (NEW manifest)
PkgMgr->>MCP: Register MCP server "astro-docs"
MCP->>MCP: Configure streamable‑HTTP transport (URL: https://mcp.docs.astro.build/mcp)
Note over User,Claude: Later – user requests Astro documentation
User->>Claude: "How do I configure Astro collections?"
Claude->>MCP: Call astro‑docs tool with query
MCP->>AstroMCP: HTTP POST (streamable) to /mcp
AstroMCP-->>MCP: Documentation response (tool result)
MCP-->>Claude: Return documentation content
Claude-->>User: Answer with relevant docs
Note over Claude,AstroMCP: No local process – entirely network‑based MCP endpoint

_{Re-trigger cubic}

sonarqubecloud · 2026-06-24T12:05:02Z

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

vercelBotdeployed to Preview June 24, 2026 11:49 View deployment

gemini-code-assistBot reviewed Jun 24, 2026
View reviewed changes

Comment threadplugins/astro/.claude-plugin/plugin.json

cubic-dev-aiBot reviewed Jun 24, 2026
View reviewed changes

amondnet merged commit ff07910 into mainJun 24, 2026
13 checks passed

amondnet deleted the amondnet/astro branch June 24, 2026 11:57

pleaseai-release-botBot mentioned this pull request Jun 24, 2026
chore: release main #234
Merged

pleaseai-release-botBot mentioned this pull request Jun 24, 2026
chore: release main #235
Merged

coderabbitaiBot mentioned this pull request Jun 30, 2026
Add Hermes Tweet plugin listing #237
Merged

coderabbitaiBot mentioned this pull request Jul 7, 2026
feat(shadcn-ui): add shadcn/ui plugin bundling official skills #255
Merged
5 tasks

Navigation Menu

Uh oh!

feat(astro): add Astro Docs MCP plugin - #232

feat(astro): add Astro Docs MCP plugin#232
amondnet merged 1 commit into
mainfrom
amondnet/astro

amondnet commented Jun 24, 2026•
edited by coderabbitai Bot
Loading

Uh oh!

vercelBot commented Jun 24, 2026•
edited
Loading

Uh oh!

coderabbitaiBot commented Jun 24, 2026•
edited
Loading

Walkthrough

Changes

Estimated code review effort

Possibly related PRs

Poem

Uh oh!

gemini-code-assistBot left a comment

Uh oh!

Uh oh!

codacy-productionBot commented Jun 24, 2026

Uh oh!

cubic-dev-aiBot left a comment

Uh oh!

Uh oh!

sonarqubecloudBot commented Jun 24, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

amondnet commented Jun 24, 2026• edited by coderabbitai BotLoading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Changes

MCP Endpoint

Multi-runtime manifests

Notes

Summary by cubic

Summary by CodeRabbit

Uh oh!

vercelBot commented Jun 24, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitaiBot commented Jun 24, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Estimated code review effort

Possibly related PRs

Poem

Uh oh!

gemini-code-assistBot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

Uh oh!

codacy-productionBot commented Jun 24, 2026

Up to standards ✅

Uh oh!

cubic-dev-aiBot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

sonarqubecloudBot commented Jun 24, 2026

Quality Gate passed

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

amondnet commented Jun 24, 2026•
edited by coderabbitai Bot
Loading

vercelBot commented Jun 24, 2026•
edited
Loading

coderabbitaiBot commented Jun 24, 2026•
edited
Loading