[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M71C4XEVTX7X4QKEWHM2DEV6":3,"skill-same:01M71C4XEVTX7X4QKEWHM2DEV6":75},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":29,"publishedAt":48,"linkOnly":49,"markdownContent":50,"markdownBody":51,"frontMatter":52,"refName":54,"commitSha":55,"skillDirectory":56,"forksCount":14,"repositoryHtmlUrl":57,"repositoryHomepageUrl":6,"ownerHtmlUrl":58,"ownerBlogUrl":6,"ownerDescription":59,"updatedAt":60,"install":61,"resources":74},"01M71C4XEVTX7X4QKEWHM2DEV6","mcp-builder",null,"MCP (Model Context Protocol) server building principles. Tool design, resource patterns, best practices.","yqecea\u002Fgem-swarm","yqecea","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F196189405?v=4","01M71C12KWH5QPTE12J69335KF","Yusuf","01M71C12MFS3BRGNE5SSHB4DY9",1,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fyqecea\u002Fgem-swarm\u002Fblob\u002Fmain\u002Fsrc\u002Fskills\u002Fdomain\u002Fmcp-builder\u002FSKILL.md",[18,23,26],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":27,"categoryName":28,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",[30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47],"MCP","mcp builder","builder","grep","protocol","principles","best practices","tool","context","patterns","edit","write","read","server","model context protocol","tool design","design","model","2026-11-10 10:12:30",false,"---\nname: mcp-builder\ndescription: MCP (Model Context Protocol) server building principles. Tool design, resource patterns, best practices.\nallowed-tools: Read, Write, Edit, Glob, Grep\n---\n\n# MCP Builder\n\n> Principles for building MCP servers.\n\n---\n\n## 1. MCP Overview\n\n### What is MCP?\n\nModel Context Protocol - standard for connecting AI systems with external tools and data sources.\n\n### Core Concepts\n\n| Concept | Purpose |\n|---------|---------|\n| **Tools** | Functions AI can call |\n| **Resources** | Data AI can read |\n| **Prompts** | Pre-defined prompt templates |\n\n---\n\n## 2. Server Architecture\n\n### Project Structure\n\n```\nmy-mcp-server\u002F\n├── src\u002F\n│   └── index.ts      # Main entry\n├── package.json\n└── tsconfig.json\n```\n\n### Transport Types\n\n| Type | Use |\n|------|-----|\n| **Stdio** | Local, CLI-based |\n| **SSE** | Web-based, streaming |\n| **WebSocket** | Real-time, bidirectional |\n\n---\n\n## 3. Tool Design Principles\n\n### Good Tool Design\n\n| Principle | Description |\n|-----------|-------------|\n| Clear name | Action-oriented (get_weather, create_user) |\n| Single purpose | One thing well |\n| Validated input | Schema with types and descriptions |\n| Structured output | Predictable response format |\n\n### Input Schema Design\n\n| Field | Required? |\n|-------|-----------|\n| Type | Yes - object |\n| Properties | Define each param |\n| Required | List mandatory params |\n| Description | Human-readable |\n\n---\n\n## 4. Resource Patterns\n\n### Resource Types\n\n| Type | Use |\n|------|-----|\n| Static | Fixed data (config, docs) |\n| Dynamic | Generated on request |\n| Template | URI with parameters |\n\n### URI Patterns\n\n| Pattern | Example |\n|---------|---------|\n| Fixed | `docs:\u002F\u002Freadme` |\n| Parameterized | `users:\u002F\u002F{userId}` |\n| Collection | `files:\u002F\u002Fproject\u002F*` |\n\n---\n\n## 5. Error Handling\n\n### Error Types\n\n| Situation | Response |\n|-----------|----------|\n| Invalid params | Validation error message |\n| Not found | Clear \"not found\" |\n| Server error | Generic error, log details |\n\n### Best Practices\n\n- Return structured errors\n- Don't expose internal details\n- Log for debugging\n- Provide actionable messages\n\n---\n\n## 6. Multimodal Handling\n\n### Supported Types\n\n| Type | Encoding |\n|------|----------|\n| Text | Plain text |\n| Images | Base64 + MIME type |\n| Files | Base64 + MIME type |\n\n---\n\n## 7. Security Principles\n\n### Input Validation\n\n- Validate all tool inputs\n- Sanitize user-provided data\n- Limit resource access\n\n### API Keys\n\n- Use environment variables\n- Don't log secrets\n- Validate permissions\n\n---\n\n## 8. Configuration\n\n### Claude Desktop Config\n\n| Field | Purpose |\n|-------|---------|\n| command | Executable to run |\n| args | Command arguments |\n| env | Environment variables |\n\n---\n\n## 9. Testing\n\n### Test Categories\n\n| Type | Focus |\n|------|-------|\n| Unit | Tool logic |\n| Integration | Full server |\n| Contract | Schema validation |\n\n---\n\n## 10. Best Practices Checklist\n\n- [ ] Clear, action-oriented tool names\n- [ ] Complete input schemas with descriptions\n- [ ] Structured JSON output\n- [ ] Error handling for all cases\n- [ ] Input validation\n- [ ] Environment-based configuration\n- [ ] Logging for debugging\n\n---\n\n> **Remember:** MCP tools should be simple, focused, and well-documented. The AI relies on descriptions to use them correctly.\n","# MCP Builder\n\n> Principles for building MCP servers.\n\n---\n\n## 1. MCP Overview\n\n### What is MCP?\n\nModel Context Protocol - standard for connecting AI systems with external tools and data sources.\n\n### Core Concepts\n\n| Concept | Purpose |\n|---------|---------|\n| **Tools** | Functions AI can call |\n| **Resources** | Data AI can read |\n| **Prompts** | Pre-defined prompt templates |\n\n---\n\n## 2. Server Architecture\n\n### Project Structure\n\n```\nmy-mcp-server\u002F\n├── src\u002F\n│   └── index.ts      # Main entry\n├── package.json\n└── tsconfig.json\n```\n\n### Transport Types\n\n| Type | Use |\n|------|-----|\n| **Stdio** | Local, CLI-based |\n| **SSE** | Web-based, streaming |\n| **WebSocket** | Real-time, bidirectional |\n\n---\n\n## 3. Tool Design Principles\n\n### Good Tool Design\n\n| Principle | Description |\n|-----------|-------------|\n| Clear name | Action-oriented (get_weather, create_user) |\n| Single purpose | One thing well |\n| Validated input | Schema with types and descriptions |\n| Structured output | Predictable response format |\n\n### Input Schema Design\n\n| Field | Required? |\n|-------|-----------|\n| Type | Yes - object |\n| Properties | Define each param |\n| Required | List mandatory params |\n| Description | Human-readable |\n\n---\n\n## 4. Resource Patterns\n\n### Resource Types\n\n| Type | Use |\n|------|-----|\n| Static | Fixed data (config, docs) |\n| Dynamic | Generated on request |\n| Template | URI with parameters |\n\n### URI Patterns\n\n| Pattern | Example |\n|---------|---------|\n| Fixed | `docs:\u002F\u002Freadme` |\n| Parameterized | `users:\u002F\u002F{userId}` |\n| Collection | `files:\u002F\u002Fproject\u002F*` |\n\n---\n\n## 5. Error Handling\n\n### Error Types\n\n| Situation | Response |\n|-----------|----------|\n| Invalid params | Validation error message |\n| Not found | Clear \"not found\" |\n| Server error | Generic error, log details |\n\n### Best Practices\n\n- Return structured errors\n- Don't expose internal details\n- Log for debugging\n- Provide actionable messages\n\n---\n\n## 6. Multimodal Handling\n\n### Supported Types\n\n| Type | Encoding |\n|------|----------|\n| Text | Plain text |\n| Images | Base64 + MIME type |\n| Files | Base64 + MIME type |\n\n---\n\n## 7. Security Principles\n\n### Input Validation\n\n- Validate all tool inputs\n- Sanitize user-provided data\n- Limit resource access\n\n### API Keys\n\n- Use environment variables\n- Don't log secrets\n- Validate permissions\n\n---\n\n## 8. Configuration\n\n### Claude Desktop Config\n\n| Field | Purpose |\n|-------|---------|\n| command | Executable to run |\n| args | Command arguments |\n| env | Environment variables |\n\n---\n\n## 9. Testing\n\n### Test Categories\n\n| Type | Focus |\n|------|-------|\n| Unit | Tool logic |\n| Integration | Full server |\n| Contract | Schema validation |\n\n---\n\n## 10. Best Practices Checklist\n\n- [ ] Clear, action-oriented tool names\n- [ ] Complete input schemas with descriptions\n- [ ] Structured JSON output\n- [ ] Error handling for all cases\n- [ ] Input validation\n- [ ] Environment-based configuration\n- [ ] Logging for debugging\n\n---\n\n> **Remember:** MCP tools should be simple, focused, and well-documented. The AI relies on descriptions to use them correctly.\n",{"name":5,"description":7,"allowed-tools":53},"Read, Write, Edit, Glob, Grep","main","923c514d4d5e15bbfd65ec7eaf949a997679aa3e","src\u002Fskills\u002Fdomain\u002Fmcp-builder","https:\u002F\u002Fgithub.com\u002Fyqecea\u002Fgem-swarm","https:\u002F\u002Fgithub.com\u002Fyqecea","15 y.o Data Science,Student","2026-04-26 20:00:27",{"source":8,"skillName":5,"commands":62,"prompt":72,"zipAvailable":73},[63,66,69],{"tool":64,"command":65},"npx","npx skills add yqecea\u002Fgem-swarm --skill mcp-builder",{"tool":67,"command":68},"bunx","bunx skills add yqecea\u002Fgem-swarm --skill mcp-builder",{"tool":70,"command":71},"pnpm","pnpm dlx skills add yqecea\u002Fgem-swarm --skill mcp-builder","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fyqecea\u002Fgem-swarm\u002Fblob\u002Fmain\u002Fsrc\u002Fskills\u002Fdomain\u002Fmcp-builder\u002FSKILL.md",true,[],[76,90,104,115,127,147],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":48},"01M71C74XVPP23ST10E8MYJZA0","validation","Cross-cutting validation methodology for verifying phase outputs and project integrity","https:\u002F\u002Fgithub.com\u002Fyqecea\u002Fgem-swarm\u002Fblob\u002Fmain\u002Fsrc\u002Fskills\u002Fshared\u002Fvalidation\u002FSKILL.md",[],[78,83,84,85,86,87,88,89],"validation methodology","for","project","outputs","phase","methodology","integrity",{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":48},"01M71C72PTKRV481M975R3QDDE","session-management","Manages orchestration session state, tracking, and resumption","https:\u002F\u002Fgithub.com\u002Fyqecea\u002Fgem-swarm\u002Fblob\u002Fmain\u002Fsrc\u002Fskills\u002Fshared\u002Fsession-management\u002FSKILL.md",[],[97,98,99,100,101,102,103],"session management","session","management","session state","orchestration","state","tracking",{"skillNo":105,"name":106,"nameZh":6,"description":107,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":108,"categories":109,"keywords":110,"publishedAt":48},"01M71C6ZY1EGM4SGVYT4B2HHD7","implementation-planning","Generates detailed implementation plans from finalized designs","https:\u002F\u002Fgithub.com\u002Fyqecea\u002Fgem-swarm\u002Fblob\u002Fmain\u002Fsrc\u002Fskills\u002Fshared\u002Fimplementation-planning\u002FSKILL.md",[],[111,112,113,114],"planning","implementation","implementation planning","plans",{"skillNo":116,"name":117,"nameZh":6,"description":118,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":119,"categories":120,"keywords":121,"publishedAt":48},"01M71C6XQVGMDFJ50BP5SBDS76","execution","Phase execution methodology for orchestration workflows with error handling and completion protocols","https:\u002F\u002Fgithub.com\u002Fyqecea\u002Fgem-swarm\u002Fblob\u002Fmain\u002Fsrc\u002Fskills\u002Fshared\u002Fexecution\u002FSKILL.md",[],[117,84,88,122,123,101,87,124,125,126],"error","workflows","protocols","error handling","with",{"skillNo":128,"name":129,"nameZh":6,"description":130,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":131,"categories":132,"keywords":139,"publishedAt":48},"01M71C6VY8APWMNK1XEJ3WP7A2","design-dialogue","Guides structured design conversations for complex engineering tasks","https:\u002F\u002Fgithub.com\u002Fyqecea\u002Fgem-swarm\u002Fblob\u002Fmain\u002Fsrc\u002Fskills\u002Fshared\u002Fdesign-dialogue\u002FSKILL.md",[133,134],{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":135,"categoryName":136,"taxonomyType":137,"taxonomyTypeDesc":138},"01JBSEEDCAT000000000000032","设计师","PROFESSION","适用职业",[140,46,141,142,143,84,144,145,146],"dialogue","design dialogue","guides","conversations","tasks","engineering","structured",{"skillNo":148,"name":149,"nameZh":6,"description":150,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":151,"categories":152,"keywords":155,"publishedAt":48},"01M71C6R4RJWG3S2R26778TPD8","delegation","Agent delegation best practices for constructing effective subagent prompts with proper scoping","https:\u002F\u002Fgithub.com\u002Fyqecea\u002Fgem-swarm\u002Fblob\u002Fmain\u002Fsrc\u002Fskills\u002Fshared\u002Fdelegation\u002FSKILL.md",[153,154],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":27,"categoryName":28,"taxonomyType":21,"taxonomyTypeDesc":22},[149,156,157,84,36,126,158],"subagent","scoping","prompts"]