克劳德·奥克勒·麦克普
______________________________________________________________________
安装
要求：
来自shell：
claude mcp add claude-oracle-mcp -- npx claude-oracle-mcp从内部克劳德 （需要重新启动）：
Add this to our global mcp config: npx claude-oracle-mcp
Install this mcp: https://github.com/Vvkmnn/claude-oracle-mcp从任何手动配置 mcp.json：（光标、风帆等）
{
"mcpServers": {
"claude-oracle-mcp": {
"command": "npx",
"args": ["claude-oracle-mcp"],
"env": {
"SKILLSMP_API_KEY": "optional-for-semantic-search",
"GITHUB_TOKEN": "optional-for-higher-rate-limits"
}
}
}
}有 不 npm install 必需的 --没有外部依赖或本地数据库，只有搜索算法。
然而，如果 npx 解决错误的包，您可以使用以下命令强制解决：
npm install -g claude-oracle-mcp技能
可选地，安装技能来教Claude何时主动使用oracle：
npx skills add Vvkmnn/claude-oracle-mcp --skill claude-oracle --global
# Optional: add --yes to skip interactive prompt and install to all agents这使得Claude在计划之前、遇到错误时或会话开始时自动搜索相关工具。MCP在没有技能的情况下工作，但技能提高了可发现性。
插件
对于带有钩子的自动工具发现，请从安装 克劳德商场 市场：
/plugin marketplace add Vvkmnn/claude-emporium
/plugin install claude-oracle@claude-emporium这 克劳德神谕 插件提供：
钩子 （有针对性，外部搜索前开火）：
- 在WebSearch/WebFetch之前→ 首先检查oracle是否有现有工具
- 进入计划模式之前→ 搜索相关插件/技能
命令： /oracle-search
需要先安装MCP服务器。请参阅商场了解其他Claude Code插件和MCP。
特征
MCP服务器 这使克劳德可以从17个注册表+GitHub搜索+网络搜索中访问15000多种技能、插件和MCP服务器。通过智能优先级快速发现。
在当地运行（具有水晶般的视觉 🔮):
search
在所有资源中搜索相关工具和解决方案。
🔮 search query=
> "Are there any MCP servers for PostgreSQL?"
> "What testing frameworks exist for React?"
> "Do we have authentication plugins?"🔮 search | postgres
╭─ 🔮 ─────────────────────────────── Found 5 ─╮
│ • postgres-mcp (mcp) │
│ PostgreSQL database access │
│ smithery.ai • ⭐ verified │
│ Install: npx postgres-mcp │
│ │
│ • postgresql-mcp (mcp) │
│ PostgreSQL MCP server │
│ npmjs.com • ✨ quality │
│ Install: npx @scope/postgresql-mcp │
│ │
│ Total: 19 sources • 15,000+ resources │
╰──────────────────────────────────────────────╯{
"results": [
{
"name": "postgres-mcp",
"type": "mcp",
"description": "PostgreSQL database access",
"source": "smithery.ai",
"install_command": "npx postgres-mcp",
"verified": true,
"stars": 142
},
{
"name": "postgresql-mcp",
"type": "mcp",
"description": "PostgreSQL MCP server",
"source": "npmjs.com",
"install_command": "npx @scope/postgresql-mcp",
"quality_score": 0.85
}
],
"sources_searched": ["smithery.ai", "npmjs.com", "glama.ai", "modelcontextprotocol.io"],
"total_available": 15000,
"cached": false
}browse
按类别、类型或流行度浏览资源。
🔮 browse category=
> "Browse testing tools"
> "Show MCP servers only"
> "Find security-related skills"🔮 browse | testing
╭─ 🔮 ─────────────────────────────── Found 8 ─╮
│ • tdd-workflows (plugin) │
│ Test-driven development workflow │
│ claude-code-plugins-plus • 258 plugins │
│ │
│ • pytest-mcp (mcp) │
│ Python testing framework │
│ smithery.ai • ⭐ verified │
│ │
│ Total: 19 sources • 15,000+ resources │
╰──────────────────────────────────────────────╯{
"results": [
{
"name": "tdd-workflows",
"type": "plugin",
"description": "Test-driven development workflow",
"source": "claude-code-plugins-plus",
"install_command": "git clone https://github.com/user/tdd-workflows ~/.claude/plugins/tdd-workflows",
"category": "testing"
},
{
"name": "pytest-mcp",
"type": "mcp",
"description": "Python testing framework",
"source": "smithery.ai",
"install_command": "npx pytest-mcp",
"verified": true
}
],
"sources_searched": ["claude-code-plugins-plus", "smithery.ai", "npmjs.com"],
"total_available": 15000,
"cached": true
}sources
显示所有可用数据源及其状态。
🔮 sources
> "Which sources are available?"
> "Check data source health"🔮 sources | 19 total
╭─ 🔮 ─────────────────────────────── 15,000+ total ─╮
│ Plugins (303): │
│ • claude-code-plugins-plus: 258 ✓ │
│ • claude-plugins-official: 45 ✓ │
│ │
│ MCP Servers (14,358): │
│ • smithery.ai: 500 ✓ │
│ • playbooks.com: 1,000+ ✓ │
│ • npmjs.com: 250 ✓ │
│ • modelcontextprotocol.io: 248 ✓ │
│ • glama.ai: 662 ✓ │
│ • wong2/awesome-mcp-servers: 200+ ✓ │
│ • punkpeye/awesome-mcp-servers: 400+ ✓ │
│ • collabnix/awesome-mcp-lists: 100+ ✓ │
│ │
│ Skills (339): │
│ • awesome-agent-skills: 339 ✓ │
│ • awesome-claude-code: 200+ ✓ │
│ • jmanhype/awesome-claude-code: 50+ ✓ │
│ • skillsmp: 25,000 (optional key) │
╰────────────────────────────────────────────────────╯{
"sources": [
{ "name": "claude-code-plugins-plus", "type": "plugin", "count": 258, "status": "ok" },
{ "name": "claude-plugins-official", "type": "plugin", "count": 45, "status": "ok" },
{ "name": "smithery.ai", "type": "mcp", "count": 500, "status": "ok" },
{ "name": "playbooks.com", "type": "mcp", "count": 1000, "status": "ok" },
{ "name": "npmjs.com", "type": "mcp", "count": 250, "status": "ok" },
{ "name": "modelcontextprotocol.io", "type": "mcp", "count": 248, "status": "ok" },
{ "name": "glama.ai", "type": "mcp", "count": 662, "status": "ok" },
{ "name": "awesome-agent-skills", "type": "skill", "count": 339, "status": "ok" },
{ "name": "skillsmp", "type": "skill", "count": 25000, "status": "no_key" }
],
"total": 15000
}方法论
User: "What MCP servers exist for PostgreSQL?"
↓
┌─────────────────────┐
│ 🔮 claude-oracle │
│ MCP Server │
└─────────┬───────────┘
│
┌──────────────┼──────────────┐
│ PARALLEL SEARCH (19) │
└──────────────┬───────────────┘
│
┌───────────────────┼───────────────────┐
│ │ │
┌───▼────┐ ┌────▼─────┐ ┌────▼─────┐
│Smithery│ │ npm │ │ Glama.ai │
│ 500 │ │ 250 │ │ 662 │
└────────┘ └──────────┘ └──────────┘
│ │ │
└───────────────────┼───────────────────┘
│
┌─────────▼───────────┐
│ DEDUPLICATE & │
│ RANK RESULTS │
└─────────┬───────────┘
│
┌─────────▼───────────┐
│ FORMAT & RETURN │
│ 🔮 Beautiful │
│ Bordered Output │
└─────────────────────┘核心特征：
- 17个注册表+GitHub搜索+网络搜索：Smithery、npm、Glama.ai、GitHub、精彩列表+更多
- 15000+资源：技能、插件和MCP服务器一次搜索
- 并行取数：同时搜索所有来源（约3秒）
- 智能缓存：内存TTL缓存（6-24小时到期）
- 关键词评分：加权匹配（精确>以>开头>包含）
- 质量信号：星级、认证徽章、质量分数提升排名
- 漂亮的格式：带边框的输出🔮 标识符
数据源（零配置，16/17注册表）：
| 来源 | 类型 | 计数 | 方法 |
|---|---|---|---|
| Smithery注册表 | MCP | 500 | REST API（5页） |
| 播放手册 | MCP | 1000+ | XML网站地图 |
| MCP官方注册 | MCP | 248 | REST API（3次迭代） |
| npm注册表 | MCP/插件 | 250 | 搜索API（1页） |
| Glama.ai | MCP | 662 | RSS订阅源 |
| wong2/很棒的mcp服务器 | mcp | 200+ | GitHub Markdown |
| punkpeye/很棒的mcp服务器 | mcp | 400+ | GitHub Markdown |
| collabnix/很棒的mcp列表 | mcp | 100+ | GitHub Markdown |
| jmanhype/很棒的claude代码 | 插件/技能 | 50+ | GitHub Markdown |
| hesreally他/真棒claude代码 | 技能 | 200+ | GitHub Markdown |
| 出色的代理技能 | 技能 | 339 | GitHub Markdown |
| claude代码插件加 | 插件 | 258 | 市场JSON |
| claude插件官方 | 插件 | 45 | 市场JSON |
| superpowers市场 | 插件 | - | 市场JSON |
基于查询（按查询搜索，零配置）：
| 来源 | 类型 | 计数 | 方法 |
|---|---|---|---|
| GitHub（搜索） | MCP/插件 | ~20 | REST API（每个查询） |
| Web（搜索） | MCP/插件 | ~10 | DuckDuckGo Lite（每次查询） |
可选（需要API密钥）：
- 技能MP：25000多种语义搜索技能(获取密钥)
- GITHUB令牌：更高的GitHub API速率限制（10→30请求/分钟）
注： 分页是有限的，以获得更快的响应（~3s）。通过缓存在后续搜索中提供完整的数据集。
设计原则：
- 聚合搜索 --单查询可同时搜索17个注册表、GitHub和web
- 零配置 --18/19源在没有API密钥的情况下工作（GITHUB_TOKEN对于速率限制是可选的）
- 去重 --基于名称相似性的跨源结果合并
- 相关性评分 --加权名称匹配、描述匹配和流行度
- 离线回退 --无法访问源时的优雅降级
替代方案
每个MCP发现工具要么搜索单个注册表，要么要求每个源都有单独的帐户。Oracle在一个命令中聚合了19个源。
| 特点 | 甲骨文 | 1mcpserver | 单个注册表 |
|---|---|---|---|
| 资源类型 | MCP+插件+技能 | 仅限MCP服务器 | 通常为一种类型 |
| 来源 | 19（注册表+精彩列表+GitHub+网络） | 注册表搜索 | 一次一个源 |
| 技能/插件 | 是（339项技能，303个插件） | 否 | 通常不会 |
| 设置 | 一个MCP，一个命令 | 一个MCP，一个命令 | 每个注册表单独的帐户/API |
| 交叉来源 | 重复、排名结果 | 每个注册表 | 手动比较 |
| 缓存 | 内存TTL（6-24h） | 根据请求 | 各不相同 |
| 安装命令 | 包含在结果中 | 包含在结果中 | 各不相同 |
1mcp服务器 --从多个注册表中发现MCP服务器。只搜索MCP服务器——没有插件，没有技能。每个注册表的结果没有跨源数据删除或排名。请求之间没有缓存。
史密瑟里, 格拉玛, 技能MP --单独的注册表，每个注册表都可以独立搜索。每个注册表需要单独的帐户或API访问权限。每个都涵盖了生态系统的一个子集——没有一个单一的来源拥有一切。手动比较注册表以找到最佳选项。Oracle将所有这些（以及另外16个源）与经过重复数据消除和排序的结果聚合在一个查询中。
发展
git clone https://github.com/Vvkmnn/claude-oracle-mcp && cd claude-oracle-mcp
npm install && npm run build
npm test包装要求：
- Node.js：>=20.0.0（ES模块）
- 运行时:
@modelcontextprotocol/sdk,fast-xml-parser - 零外部数据库 --与合作
npx
开发工作流程：
npm run build # TypeScript compilation with executable permissions
npm run dev # Watch mode with tsc --watch
npm run start # Run the MCP server directly
npm run lint # ESLint code quality checks
npm run lint:fix # Auto-fix linting issues
npm run format # Prettier formatting (src/)
npm run format:check # Check formatting without changes
npm run typecheck # TypeScript validation without emit
npm run test # Lint + type check
npm run prepublishOnly # Pre-publish validation (build + lint + format:check)Git钩子（通过赫斯基）：
- 预承诺：自动格式化已暂存
.ts使用Prettier和ESLint的文件
贡献：
- 分叉存储库并创建功能分支
- 在提交PR之前，使用多个数据源进行测试
- 遵循TypeScript严格模式 MCP协议 标准
从示例中学习：
- 官方MCP服务器 供参考实现
- TypeScript SDK 最佳实践
- 用于npm包开发
许可证
_埃涅阿斯和库迈Sibyl 通过 克劳德 梅兰引导埃涅阿斯穿越冥界的神谕。_