Skip to content

Add mcp-spec Claude Code plugin with GitHub search skill#2214

Draft
olaservo wants to merge 10 commits intomodelcontextprotocol:mainfrom
olaservo:add-mcp-spec-plugin
Draft

Add mcp-spec Claude Code plugin with GitHub search skill#2214
olaservo wants to merge 10 commits intomodelcontextprotocol:mainfrom
olaservo:add-mcp-spec-plugin

Conversation

@olaservo
Copy link
Member

@olaservo olaservo commented Feb 6, 2026

Summary

  • Adds a Claude Code plugin (plugins/mcp-spec) for researching and contributing to the MCP specification
  • Includes a search-mcp-github skill that searches across org discussions, spec discussions, issues, and PRs
  • Bundles the official MCP docs server (https://modelcontextprotocol.io/mcp) for spec-level lookups
  • Supports deep diving into PR inline review comments, review summaries, and top-level comments
  • Generates search term variants (camelCase, separated words, etc.) to avoid missed results
  • Highlights notable maintainer quotes with footnote citations

Test plan

  • Install plugin and verify /search-mcp-github skill is available
  • Test search with a multi-word topic (e.g., "Tool Annotations") and verify variant searches run
  • Verify MCP docs server is connected and SearchModelContextProtocol tool is available
  • Test PR deep dive commands on a known PR with inline review comments
  • Verify output includes maintainer quotes with footnote citations

🤖 Generated with Claude Code

olaservo and others added 6 commits February 6, 2026 06:05
Adds a plugin for researching and contributing to the MCP specification,
including a search-mcp-github skill that searches across org discussions,
spec discussions, issues, and PRs.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Adds commands for fetching inline review comments, review summaries,
and top-level comments on PRs — where the substantive design discussion
often lives but is not surfaced by `gh pr view`.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Bundles the official MCP documentation server (https://modelcontextprotocol.io/mcp)
as a plugin MCP server so the SearchModelContextProtocol tool is available for
spec-level lookups. Updates the skill to prefer the docs server for current spec
content before falling back to GitHub searches. Also fixes license to Apache-2.0
to match the repo's license for new contributions.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
GitHub search treats "ToolAnnotations" and "Tool Annotations" as different
queries, causing missed results. The skill now instructs the agent to
generate camelCase, separated, hyphenated, and singular/plural variants
before searching.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Instructs the skill to highlight notable quotes from maintainers with
direct attribution, and collect all sources as footnotes at the end
of the output for easy reference.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@olaservo olaservo marked this pull request as draft February 6, 2026 13:28
olaservo and others added 4 commits February 6, 2026 06:29
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Rewrite `SKILL.md` to be more concise and information-dense while
preserving all functional guidance. Reduces the file from ~160 to ~118
lines by:

- Replacing verbose source table and separate command sections with a
  compact "Where to search" overview
- Consolidating discussion GraphQL queries and adding `author`/
  `authorAssociation` fields for maintainer identification
- Dropping kebab-case search variants (GitHub tokenizes on hyphens, so
  they behave like space-separated and add noise)
- Replacing full bash examples in the PR deep-dive section with REST API
  endpoint paths
- Switching output format to fenced template blocks with dates
- Condensing the 7-step execution plan to 6 shorter steps
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants