Skip to content

feat(mcp-integration): add MCP server discovery via PulseMCP#80

Merged
sjnims merged 1 commit intomainfrom
feature/mcp-server-discovery
Dec 9, 2025
Merged

feat(mcp-integration): add MCP server discovery via PulseMCP#80
sjnims merged 1 commit intomainfrom
feature/mcp-server-discovery

Conversation

@sjnims
Copy link
Copy Markdown
Owner

@sjnims sjnims commented Dec 9, 2025

Summary

  • Add contextual MCP server discovery to the mcp-integration skill using PulseMCP directory
  • Enable Claude to recommend relevant MCP servers based on user needs
  • Provide curated quick reference for common use cases

Changes

New: references/server-discovery.md

Comprehensive reference document covering:

  • Discovery method: Step-by-step Tavily extract instructions with URL patterns
  • Parsing guidance: What fields to extract from search results
  • Evaluation criteria: How to rank/recommend servers (official vs community, popularity)
  • Quick reference: Curated top servers by category (databases, productivity, dev tools, cloud, AI, storage)
  • Integration workflow: From discovery → detail fetch → configuration
  • Fallback: WebFetch alternative if Tavily unavailable
  • Bonus: Documents the PulseMCP MCP server for plugins needing programmatic discovery

Modified: SKILL.md

  • Updated frontmatter with discovery triggers: "find MCP server", "discover MCP servers", "what MCP servers exist", "recommend MCP server for [service]"
  • Added "Discovering MCP Servers" section with brief workflow
  • Added server-discovery.md to Additional Resources

Test plan

  • Verify skill triggers on discovery phrases ("find MCP server for databases")
  • Confirm Tavily extract returns parseable PulseMCP results
  • Test curated quick reference accuracy for common categories
  • Verify markdownlint passes (already confirmed locally)

🤖 Generated with Claude Code

Add contextual MCP server recommendations using PulseMCP directory:

- Add references/server-discovery.md with Tavily-based search instructions
- Include URL patterns, parsing guidance, and evaluation criteria
- Add curated quick reference for common categories (databases, productivity, etc.)
- Update SKILL.md frontmatter with discovery trigger phrases
- Add "Discovering MCP Servers" section to SKILL.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@sjnims sjnims self-assigned this Dec 9, 2025
@claude
Copy link
Copy Markdown

claude Bot commented Dec 9, 2025

Claude finished @sjnims's task —— View job


PR Review: MCP Server Discovery

Summary

Looks great - This PR successfully adds MCP server discovery functionality to the mcp-integration skill with high-quality documentation and proper triggering.


What's Good

Excellent Trigger Phrase Coverage 🎯

  • Added strong, specific trigger phrases to SKILL.md frontmatter:
    • "find MCP server"
    • "discover MCP servers"
    • "what MCP servers exist"
    • "recommend MCP server for [service]"
  • These align perfectly with natural user queries

Progressive Disclosure Pattern 📚

  • SKILL.md provides concise overview (15 lines) pointing to detailed reference
  • references/server-discovery.md contains comprehensive 190-line guide
  • Follows the skill architecture pattern from CLAUDE.md exactly

Comprehensive Reference Documentation

  • Clear 4-step discovery workflow (Search → Parse → Evaluate → Fetch details)
  • Well-organized quick reference tables by category (Databases, Productivity, Dev Tools, Cloud, AI, Storage)
  • Practical URL patterns and search keyword guidance
  • Example workflow demonstrating end-to-end discovery process
  • Fallback method documented (WebFetch when Tavily unavailable)

Integration Quality

  • Properly references Tavily MCP tools: mcp__tavily-mcp__tavily-extract
  • Links discovery workflow to existing configuration guidance
  • Documents PulseMCP MCP server for programmatic discovery use cases

Markdown Quality

  • All files pass markdownlint with no errors
  • Consistent formatting throughout
  • Proper table structures and code blocks

Checklist Verification

From the PR test plan:

  • Skill triggers on discovery phrases - Frontmatter includes 4 strong trigger phrases
  • Tavily extract instructions - Step 1 clearly documents tool usage with URL patterns
  • Quick reference accuracy - Tables cover 6 major categories with official/community servers
  • Markdownlint passes - Confirmed locally and in this review (0 errors)

Plugin Component Validation:

  • Frontmatter - Has name and description (version optional for skills per CLAUDE.md)
  • Trigger phrases - Multiple specific phrases that match user queries
  • Progressive disclosure - Brief overview in SKILL.md, detailed content in references/
  • Documentation - Added to "Additional Resources" section

Minor Observation

The PR description mentions verifying that "Tavily extract returns parseable PulseMCP results" - this would require manual testing with the actual Tavily MCP server, which is beyond static code review scope. The instructions look sound, but real-world testing with live PulseMCP data would confirm the extraction patterns work as expected.


Recommendation: ✅ Approve and merge

This is a well-executed addition that extends the mcp-integration skill with valuable discovery capabilities. The documentation is clear, comprehensive, and follows all plugin development conventions.


@claude claude Bot added enhancement New feature or request component:skill Skills layer effort:small < 1 hour labels Dec 9, 2025
@sjnims sjnims merged commit e4ea314 into main Dec 9, 2025
8 checks passed
@sjnims sjnims deleted the feature/mcp-server-discovery branch December 9, 2025 04:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

component:skill Skills layer effort:small < 1 hour enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant