Skip to content

feat: add MCP registry integration for create-expert skill-finder#612

Merged
FL4TLiN3 merged 2 commits intomainfrom
feat/mcp-registry-skill-finder
Feb 23, 2026
Merged

feat: add MCP registry integration for create-expert skill-finder#612
FL4TLiN3 merged 2 commits intomainfrom
feat/mcp-registry-skill-finder

Conversation

@FL4TLiN3
Copy link
Contributor

Summary

  • Add searchMcpRegistry and getMcpServerDetail tools to @perstack/create-expert-skill that search the official MCP registry (registry.modelcontextprotocol.io) for MCP servers matching expert skill requirements
  • Add @create-expert/skill-finder expert that uses these tools to investigate registry entries and produce skill-report.md with ready-to-use TOML configuration snippets
  • Update coordinator, planner, and definition-writer instructions to integrate skill findings into generated expert definitions
  • CLI resolves create-expert-skill server path to absolute for CWD-independent operation

Changes

New files (apps/create-expert-skill/src/)

  • lib/mcp-registry-client.ts — Registry API client with pagination (100/page, up to 1000 servers), 10-min in-memory cache, 15s timeout, Zod validation
  • tools/search-mcp-registry.tssearchMcpRegistry tool: space-separated AND keyword matching on name+description, name-priority sorting, deprecated server exclusion
  • tools/get-mcp-server-detail.tsgetMcpServerDetail tool: fetches server detail, maps npm packages → mcpStdioSkill, SSE/streamable-http remotes → mcpSseSkill, extracts isSecret env vars for requiredEnv
  • 28 unit tests across 3 test files (client, search, detail)

Modified files

  • apps/create-expert-skill/src/server.ts / index.ts — Register and export new tools
  • apps/create-expert/bin/cli.ts — Resolve create-expert-skill server path to absolute using tomlPath as base, so skill-finder works regardless of CWD
  • apps/create-expert/perstack.toml — Add @create-expert/skill-finder expert with dual skills (@perstack/base + @perstack/create-expert-skill), update coordinator/planner/definition-writer instructions for skill integration flow
  • e2e/create-expert/create-expert.test.ts — Add assertions for searchMcpRegistry calls, skill-report.md creation, and non-base MCP skill in generated TOML; increase timeout to 900s for extended delegation chain

Test plan

  • bun run typecheck — 23/23 pass
  • bun run test — 19/19 pass (includes 28 new unit tests)
  • bun run format-and-lint — clean
  • bun run build — 23/23 pass
  • bun run validate:changeset — pass
  • E2E: bun test --timeout 900000 e2e/create-expert/create-expert.test.ts — 2/2 pass, 22 expect() calls

🤖 Generated with Claude Code

Add searchMcpRegistry and getMcpServerDetail tools to @perstack/create-expert-skill
that search the official MCP registry (registry.modelcontextprotocol.io) for servers
matching expert skill requirements. Add @create-expert/skill-finder expert that uses
these tools to investigate registry entries and produce skill-report.md with TOML
configuration snippets. Update coordinator, planner, and definition-writer instructions
to integrate skill findings into generated expert definitions.

- MCP registry client with pagination, 10-min cache, Zod validation
- searchMcpRegistry: AND keyword matching, name-priority sorting, deprecated exclusion
- getMcpServerDetail: npm→mcpStdioSkill, SSE→mcpSseSkill mapping with requiredEnv extraction
- CLI resolves create-expert-skill server path to absolute for CWD-independent operation
- E2E tests verify skill-finder calls searchMcpRegistry and produces skill-report.md
- 28 unit tests covering client, search, and detail tools

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@FL4TLiN3 FL4TLiN3 force-pushed the feat/mcp-registry-skill-finder branch from b4b35cf to 48f4cef Compare February 23, 2026 18:19
@FL4TLiN3 FL4TLiN3 enabled auto-merge (squash) February 23, 2026 20:06
@FL4TLiN3 FL4TLiN3 merged commit c1f50db into main Feb 23, 2026
11 checks passed
@FL4TLiN3 FL4TLiN3 mentioned this pull request Feb 23, 2026
@FL4TLiN3 FL4TLiN3 deleted the feat/mcp-registry-skill-finder branch February 25, 2026 13:37
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.

1 participant