[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77Z47QJ3AR7WZX3BFP79R0K":3,"skill-same:01M77Z47QJ3AR7WZX3BFP79R0K":45},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":25,"repositoryHtmlUrl":26,"repositoryHomepageUrl":27,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M77Z47QJ3AR7WZX3BFP79R0K","yuyonghao-mcp-client",null,"Lord1Egypt\u002Fawesome-skill-forge","Lord1Egypt","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F99746359?v=4","01M7592YDNT0XK9WJ0T2MQVPDN","Mohamed Mounir Ali AL Keshita","01M75GRFNHC8VZNWEB8DKDE433",3,"MIT","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fy\u002Fyuyonghao-mcp-client\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"# MCP Client Skill\n\n**version**: 0.1.0\n\nMCP (Model Context Protocol) 客户端技能，用于连接和管理外部 MCP 服务器。\n\n## 功能特性\n\n- **多传输支持**: stdio、SSE (Server-Sent Events)\n- **完整协议实现**: 工具调用、资源读取、提示词获取\n- **安全控制**: 权限验证、敏感操作确认、审计日志\n- **错误处理**: 自动重试、详细错误码\n- **事件系统**: 连接状态、工具调用事件监听\n\n## 安装\n\n```bash\n# 进入技能目录\ncd skills\u002Fmcp-client\n\n# 安装依赖\nnpm install\n```\n\n## 配置\n\n编辑 `src\u002Fmcp-config.json` 配置 MCP 服务器：\n\n```json\n{\n  \"filesystem\": {\n    \"id\": \"filesystem\",\n    \"name\": \"Filesystem Server\",\n    \"type\": \"stdio\",\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"@modelcontextprotocol\u002Fserver-filesystem\", \".\"],\n    \"description\": \"本地文件系统访问\"\n  },\n  \"github\": {\n    \"id\": \"github\",\n    \"name\": \"GitHub Server\",\n    \"type\": \"stdio\",\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"@modelcontextprotocol\u002Fserver-github\"],\n    \"env\": {\n      \"GITHUB_TOKEN\": \"your-token-here\"\n    },\n    \"description\": \"GitHub API 集成\"\n  }\n}\n```\n\n## 使用方法\n\n### 命令行\n\n```bash\n# 列出已配置的服务器\nnpm run mcp list\n\n# 连接到服务器\nnpm run mcp connect filesystem\n\n# 列出可用工具\nnpm run mcp tools filesystem\n\n# 调用工具\nnpm run mcp call filesystem read_file '{\"path\": \".\u002Fpackage.json\"}'\n\n# 读取文件\nnpm run mcp read .\u002Fpackage.json\n\n# 列出目录\nnpm run mcp ls .\u002Fsrc\n\n# 搜索文件\nnpm run mcp search \"*.js\"\n\n# 查看审计日志\nnpm run mcp audit\n```\n\n### JavaScript API\n\n```javascript\nimport { OpenClawMCPSkill } from '.\u002Fsrc\u002Fmcp-skill.js';\n\n\u002F\u002F 创建技能实例\nconst skill = new OpenClawMCPSkill({\n  autoApprove: false,        \u002F\u002F 是否需要用户批准\n  requireApproval: true,     \u002F\u002F 强制要求批准\n  autoApprovePatterns: ['*:read_*'],  \u002F\u002F 自动批准模式\n  blockedPatterns: ['*:delete_*']     \u002F\u002F 禁止模式\n});\n\n\u002F\u002F 列出服务器\nskill.listServers();\n\n\u002F\u002F 连接到服务器\nawait skill.connect('filesystem');\n\n\u002F\u002F 获取服务器信息\nconst info = await skill.getServerInfo('filesystem');\nconsole.log(info);\n\n\u002F\u002F 列出工具\nconst tools = await skill.listTools('filesystem');\n\n\u002F\u002F 调用工具\nconst result = await skill.callTool('filesystem', 'read_file', {\n  path: '.\u002Fpackage.json'\n});\n\n\u002F\u002F 快捷方法\nconst content = await skill.readFile('.\u002Fpackage.json');\nconst listing = await skill.listDirectory('.\u002Fsrc');\nconst matches = await skill.searchFiles('*.js');\n\n\u002F\u002F 批准工具（后续调用无需确认）\nskill.approveTool('filesystem', 'read_file', true);\n\n\u002F\u002F 获取审计日志\nconst logs = skill.getAuditLog(100);\n\n\u002F\u002F 关闭所有连接\nawait skill.closeAll();\n```\n\n### 直接使用客户端\n\n```javascript\nimport { MCPClient, MCPServerConfig, MCPClientConfig } from '.\u002Fsrc\u002Fclient.js';\nimport { SecureMCPClient } from '.\u002Fsrc\u002Fsecure-client.js';\n\n\u002F\u002F 基础客户端\nconst client = new MCPClient(new MCPClientConfig({\n  name: 'my-client',\n  autoApprove: true\n}));\n\n\u002F\u002F 安全客户端（带审计和重试）\nconst secureClient = new SecureMCPClient(\n  new MCPClientConfig(),\n  {\n    requireApproval: true,\n    blockedPatterns: ['*:delete_*']\n  }\n);\n\n\u002F\u002F 配置服务器\nconst serverConfig = new MCPServerConfig({\n  id: 'my-server',\n  name: 'My Server',\n  type: 'stdio',\n  command: 'node',\n  args: ['server.js']\n});\n\n\u002F\u002F 连接\nawait client.connect(serverConfig);\n\n\u002F\u002F 获取能力\nconst capabilities = await client.getServerCapabilities('my-server');\n\n\u002F\u002F 列出工具\nconst tools = await client.listTools('my-server');\n\n\u002F\u002F 调用工具\nconst result = await client.callTool('my-server', 'tool_name', {\n  arg1: 'value1'\n});\n\n\u002F\u002F 列出资源\nconst resources = await client.listResources('my-server');\n\n\u002F\u002F 读取资源\nconst resource = await client.readResource('my-server', 'file:\u002F\u002F\u002Fpath');\n\n\u002F\u002F 列出提示词\nconst prompts = await client.listPrompts('my-server');\n\n\u002F\u002F 获取提示词\nconst prompt = await client.getPrompt('my-server', 'prompt_name', {\n  arg1: 'value1'\n});\n\n\u002F\u002F 事件监听\nclient.on('connected', (data) => {\n  console.log('Connected:', data.serverId);\n});\n\nclient.on('toolCalled', (data) => {\n  console.log('Tool called:', data.toolName);\n});\n\nclient.on('resourceRead', (data) => {\n  console.log('Resource read:', data.resourceUri);\n});\n\n\u002F\u002F 断开连接\nawait client.disconnect('my-server');\n```\n\n## 支持的 MCP 服务器\n\n### stdio 类型\n- `@modelcontextprotocol\u002Fserver-filesystem` - 文件系统访问\n- `@modelcontextprotocol\u002Fserver-github` - GitHub API\n- `@modelcontextprotocol\u002Fserver-postgres` - PostgreSQL 数据库\n- `@modelcontextprotocol\u002Fserver-sqlite` - SQLite 数据库\n\n### SSE 类型\n- 任何支持 MCP SSE 协议的服务器\n- 配置示例：\n```json\n{\n  \"id\": \"remote-server\",\n  \"name\": \"Remote MCP Server\",\n  \"type\": \"sse\",\n  \"url\": \"http:\u002F\u002Flocalhost:3000\u002Fsse\",\n  \"headers\": {\n    \"Authorization\": \"Bearer token\"\n  }\n}\n```\n\n## 安全特性\n\n### 权限控制\n- 工具调用需要用户批准（可配置）\n- 资源访问需要用户批准\n- 敏感路径自动检测（.env、.git、\u002Fetc\u002Fpasswd 等）\n\n### 审计日志\n```javascript\n\u002F\u002F 获取审计日志\nconst logs = client.getAuditLog(100);\n\n\u002F\u002F 日志格式\n{\n  timestamp: Date,\n  action: 'tool_call' | 'resource_read' | 'connect' | ...,\n  details: { ... }\n}\n```\n\n### 错误处理\n```javascript\ntry {\n  await client.callTool('server', 'tool', args);\n} catch (error) {\n  console.log(error.code);      \u002F\u002F 错误码\n  console.log(error.message);   \u002F\u002F 错误消息\n  console.log(error.details);   \u002F\u002F 详细信息\n}\n```\n\n错误码：\n- `CONNECTION_FAILED` - 连接失败\n- `CONNECTION_NOT_FOUND` - 未找到连接\n- `TOOL_EXECUTION_FAILED` - 工具执行失败\n- `RESOURCE_READ_FAILED` - 资源读取失败\n- `PERMISSION_DENIED` - 权限拒绝\n- `UNSUPPORTED_TRANSPORT` - 不支持的传输类型\n\n## 测试\n\n```bash\n# 运行所有测试\nnpm test\n\n# 运行基础测试\nnpm run test\n\n# 运行安全测试\nnpm run test:security\n\n# 运行集成测试（需要实际 MCP 服务器）\nnpm run test:filesystem\n```\n\n## 项目结构\n\n```\nskills\u002Fmcp-client\u002F\n├── src\u002F\n│   ├── client.js        # 基础 MCP 客户端\n│   ├── secure-client.js # 带安全控制的客户端\n│   ├── mcp-skill.js     # OpenClaw 技能接口\n│   └── mcp-config.json  # 服务器配置\n├── test\u002F\n│   ├── client.test.js       # 基础功能测试\n│   ├── security.test.js     # 安全控制测试\n│   ├── mcp-servers.test.js  # 集成测试\n│   └── github-server.js     # GitHub 服务器测试\n├── package.json\n├── SKILL.md\n└── README.md\n```\n\n## 依赖\n\n- `@modelcontextprotocol\u002Fsdk` - 官方 MCP SDK\n- `zod` - 类型验证（可选）\n\n## 协议版本\n\n- MCP Protocol: 2024-11-05\n- SDK Version: ^1.0.0\n\n## 许可证\n\nMIT\n",{},"master","4aa004da461d820f4ea5499e58eb8d196cf99016","community\u002Fclawhub\u002Fy\u002Fyuyonghao-mcp-client",0,"https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge","https:\u002F\u002Fskill-explorer-rho.vercel.app","https:\u002F\u002Fgithub.com\u002FLord1Egypt","Unbreakable. Unstoppable. Unmatched⚡.\r\n Speaker of machine tongues 🤖  | World-builder of decentralized dreams 🌐 | Defender of the digital realm🛡️.","2026-06-10 08:21:01",{"source":7,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add Lord1Egypt\u002Fawesome-skill-forge --skill yuyonghao-mcp-client",{"tool":37,"command":38},"bunx","bunx skills add Lord1Egypt\u002Fawesome-skill-forge --skill yuyonghao-mcp-client",{"tool":40,"command":41},"pnpm","pnpm dlx skills add Lord1Egypt\u002Fawesome-skill-forge --skill yuyonghao-mcp-client","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fy\u002Fyuyonghao-mcp-client\u002FSKILL.md",true,[],[46,53,60,67,74,81],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":18},"01M785WKJB99G3STR1NF9NRTJW","youtube-content","YouTube transcripts to summaries, threads, blogs.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fyoutube-content\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":18},"01M785WEFHB0G2S9YA6EPR3H0E","xurl","X\u002FTwitter via xurl CLI: post, search, DM, media, v2 API.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fxurl\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":18},"01M785W98EDN4EFJXJPMQEHCRC","touchdesigner-mcp","Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftouchdesigner-mcp\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":18},"01M785W5S9FP3QBH2V191E025P","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":18},"01M785W2AS08NSSH9YATCV6FJB","teams-meeting-pipeline","Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fteams-meeting-pipeline\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":18},"01M785VXKW4T34BTP1SCHW1R7F","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",[],[]]