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 ✅

🟢 Issues 0 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

vercel Bot deployed to Preview June 24, 2026 11:49 View deployment

gemini-code-assist Bot reviewed Jun 24, 2026

View reviewed changes

Comment thread plugins/astro/.claude-plugin/plugin.json

cubic-dev-ai Bot reviewed Jun 24, 2026

View reviewed changes

amondnet merged commit ff07910 into main Jun 24, 2026
13 checks passed

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

pleaseai-release-bot Bot mentioned this pull request Jun 24, 2026

chore: release main #234

Merged

pleaseai-release-bot Bot mentioned this pull request Jun 24, 2026

chore: release main #235

Merged

coderabbitai Bot mentioned this pull request Jun 30, 2026

Add Hermes Tweet plugin listing #237

Merged

coderabbitai Bot mentioned this pull request Jul 7, 2026

feat(shadcn-ui): add shadcn/ui plugin bundling official skills #255

Merged

5 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

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!

vercel Bot commented Jun 24, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented Jun 24, 2026 •

edited

Loading

Walkthrough

Changes

Estimated code review effort

Possibly related PRs

Poem

Uh oh!

gemini-code-assist Bot left a comment

Uh oh!

Uh oh!

codacy-production Bot commented Jun 24, 2026

Uh oh!

cubic-dev-ai Bot left a comment

Uh oh!

Uh oh!

sonarqubecloud Bot 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 Bot Loading 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!

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

Uh oh!

Uh oh!

coderabbitai Bot 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-assist Bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

Uh oh!

codacy-production Bot commented Jun 24, 2026

Up to standards ✅

Uh oh!

cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

sonarqubecloud Bot 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

vercel Bot commented Jun 24, 2026 •

edited

Loading

coderabbitai Bot commented Jun 24, 2026 •

edited

Loading