claude-pangu 2.2.12 → 2.2.13

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://code.claude.com/plugin-schema.json",
   "name": "oh-my-claude",
-  "version": "2.2.12",
+  "version": "2.2.13",
   "hooks": "../hooks/hooks.json",
   "description": "基于中国传统文化的 Claude Code 智能编排插件 - A Claude Code plugin inspired by Chinese traditional culture",
   "author": "ZDragon17",

package/mcps/README.md

@@ -0,0 +1,113 @@
+# oh-my-claude 内置 MCP 服务器
+
+本目录包含 oh-my-claude 的 MCP (Model Context Protocol) 服务器配置参考文件。
+
+## 自动安装
+
+安装 oh-my-claude 时，以下 MCP 服务器会**自动配置**到 Claude Code 中：
+
+| MCP | 功能 | 状态 |
+|-----|------|------|
+| **context7** | 官方文档查询 | ✅ 默认启用 |
+| **grep-app** | GitHub 代码搜索 | ✅ 默认启用 |
+| **deepwiki** | 开源项目文档 | ✅ 默认启用 |
+| **open-websearch** | 网络搜索 (DuckDuckGo/Bing) | ✅ 默认启用 |
+
+## 工作原理
+
+oh-my-claude 在插件根目录提供 `.mcp.json` 文件，Claude Code 会自动读取并注册其中的 MCP 服务器。
+
+## 验证安装
+
+安装 oh-my-claude 后，在 Claude Code 中输入：
+
+```
+你能使用哪些 MCP 工具？
+```
+
+应该能看到 `context7`、`grep-app`、`deepwiki`、`open-websearch` 等工具。
+
+## 配置文件
+
+### .mcp.json (插件根目录)
+
+```json
+{
+  "context7": {
+    "command": "npx",
+    "args": ["-y", "@upstash/context7-mcp"]
+  },
+  "grep-app": {
+    "command": "npx",
+    "args": ["-y", "@anthropic/grep-app-mcp"]
+  }
+}
+```
+
+### 本目录的 JSON 文件
+
+本目录（`mcps/`）中的 JSON 文件是详细的配置参考，包含：
+- 完整的工具定义
+- 参数说明
+- 使用示例
+
+可用于了解每个 MCP 的详细功能。
+
+## 禁用 MCP
+
+如果需要禁用某个 MCP，可以在 oh-my-claude 配置中设置：
+
+```json
+{
+  "mcp": {
+    "disabled_mcps": ["deepwiki"]
+  }
+}
+```
+
+或直接编辑 `.mcp.json` 文件删除对应条目。
+
+## 添加更多 MCP
+
+### 方法一：编辑 .mcp.json
+
+在插件目录的 `.mcp.json` 中添加：
+
+```json
+{
+  "my-mcp": {
+    "command": "npx",
+    "args": ["-y", "@my-org/my-mcp-server"]
+  }
+}
+```
+
+### 方法二：使用 Claude Code 设置
+
+直接在 Claude Code 的 MCP 设置中添加。
+
+## 需要 API 密钥的 MCP
+
+某些 MCP 需要 API 密钥才能使用：
+
+| MCP | 环境变量 | 获取方式 |
+|-----|----------|----------|
+| exa | `EXA_API_KEY` | https://exa.ai |
+| postgres | `DATABASE_URL` | 自有数据库 |
+
+设置环境变量后重启 Claude Code 即可使用。
+
+## 故障排查
+
+### MCP 不工作？
+
+1. **检查 npm 可用性**：`npx --version`
+2. **手动测试 MCP**：`npx -y @upstash/context7-mcp`
+3. **检查网络**：确保能访问 npm registry
+4. **重启 Claude Code**：安装后需要重启
+
+### 常见错误
+
+- `ENOENT`: npm 包名错误或网络问题
+- `TIMEOUT`: 网络超时，检查代理设置
+- `PERMISSION`: 权限问题，检查 npm 缓存目录

package/mcps/context7.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://raw.githubusercontent.com/anthropics/anthropic-cookbook/main/misc/mcp-server-schema.json",
+  "name": "context7",
+  "description": "官方文档查询 MCP，获取任何编程库/框架的最新官方文档",
+  "version": "1.0.0",
+  "command": "npx",
+  "args": ["-y", "@anthropic-ai/mcp-context7"],
+  "env": {},
+  "tools": [
+    {
+      "name": "resolve-library-id",
+      "description": "将包/产品名称解析为 Context7 兼容的库 ID。在调用 query-docs 之前必须先调用此工具获取有效的库 ID",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "libraryName": {
+            "type": "string",
+            "description": "要搜索的库名称"
+          },
+          "query": {
+            "type": "string",
+            "description": "用户原始问题或任务，用于按相关性排序库结果"
+          }
+        },
+        "required": ["query", "libraryName"]
+      }
+    },
+    {
+      "name": "query-docs",
+      "description": "从 Context7 检索和查询任何编程库或框架的最新文档和代码示例",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "libraryId": {
+            "type": "string",
+            "description": "精确的 Context7 兼容库 ID（如 '/mongodb/docs', '/vercel/next.js'）"
+          },
+          "query": {
+            "type": "string",
+            "description": "需要帮助的问题或任务，要具体并包含相关细节"
+          }
+        },
+        "required": ["libraryId", "query"]
+      }
+    }
+  ],
+  "metadata": {
+    "provider": "Context7",
+    "website": "https://context7.com",
+    "pricing": "免费",
+    "rateLimit": "无限制"
+  }
+}

package/mcps/grep_app.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "https://raw.githubusercontent.com/anthropics/anthropic-cookbook/main/misc/mcp-server-schema.json",
+  "name": "grep_app",
+  "description": "GitHub 代码搜索 MCP，在数百万公开 GitHub 仓库中搜索代码模式和实现示例",
+  "version": "1.0.0",
+  "command": "npx",
+  "args": ["-y", "@anthropic-ai/mcp-grep-app"],
+  "env": {},
+  "tools": [
+    {
+      "name": "searchGitHub",
+      "description": "从数百万公开 GitHub 仓库中查找真实代码示例。搜索字面代码模式（如 grep），而非关键词。适用于：实现不熟悉的 API、查找正确的语法/参数、寻找生产级示例和最佳实践",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string",
+            "description": "要搜索的字面代码模式（如 'useState('、'import React from'、'async function'）"
+          },
+          "language": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "按编程语言过滤（如 ['TypeScript', 'TSX']、['Python']）"
+          },
+          "repo": {
+            "type": "string",
+            "description": "按仓库过滤（如 'facebook/react'、'vercel/ai'）"
+          },
+          "path": {
+            "type": "string",
+            "description": "按文件路径过滤（如 'src/components/'、'README.md'）"
+          },
+          "useRegexp": {
+            "type": "boolean",
+            "description": "是否将查询解释为正则表达式",
+            "default": false
+          },
+          "matchCase": {
+            "type": "boolean",
+            "description": "是否区分大小写",
+            "default": false
+          },
+          "matchWholeWords": {
+            "type": "boolean",
+            "description": "是否仅匹配完整单词",
+            "default": false
+          }
+        },
+        "required": ["query"]
+      }
+    }
+  ],
+  "metadata": {
+    "provider": "grep.app",
+    "website": "https://grep.app",
+    "pricing": "免费",
+    "rateLimit": "合理使用"
+  }
+}

package/mcps/websearch.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "https://raw.githubusercontent.com/anthropics/anthropic-cookbook/main/misc/mcp-server-schema.json",
+  "name": "websearch",
+  "description": "实时网络搜索 MCP，基于 Exa AI 提供高质量搜索结果",
+  "version": "1.0.0",
+  "command": "npx",
+  "args": ["-y", "@anthropic-ai/mcp-exa-search"],
+  "env": {
+    "EXA_API_KEY": "${EXA_API_KEY}"
+  },
+  "tools": [
+    {
+      "name": "web_search",
+      "description": "搜索网络获取最新信息。适用于查找新闻、文章、博客、产品信息等",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string",
+            "description": "搜索查询词"
+          },
+          "numResults": {
+            "type": "number",
+            "description": "返回结果数量，默认 10",
+            "default": 10
+          },
+          "type": {
+            "type": "string",
+            "enum": ["auto", "keyword", "neural"],
+            "description": "搜索类型：auto（自动）、keyword（关键词）、neural（语义）",
+            "default": "auto"
+          }
+        },
+        "required": ["query"]
+      }
+    }
+  ],
+  "metadata": {
+    "provider": "Exa AI",
+    "website": "https://exa.ai",
+    "pricing": "免费额度 + 按量付费",
+    "rateLimit": "1000 次/月（免费）"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-pangu",
-  "version": "2.2.12",
+  "version": "2.2.13",
   "description": "基于中国传统文化的 Claude Code 智能编排插件 - A Claude Code plugin inspired by Chinese traditional culture (原名 oh-my-claude)",
   "keywords": [
     "claude-code",
@@ -35,6 +35,7 @@
     "commands/",
     "hooks/",
     "skills/",
+    "mcps/",
     ".claude-plugin/",
     "scripts/",
     "README.md",