开放搜索MCP

Name: 开放搜索MCP
Author: flyanima

作者：flyanima2 星标更新：2025-07-16

安装使用来源：spider==github.com

项目介绍

技术文档摘要

Open Search MCP 🔍

一个全面的模型上下文协议（MCP）服务器，提供33种专门的研究和搜索工具给Claude Desktop。设计用于需要强大搜索能力的研究人员、开发者和知识工作者，覆盖学术、技术和通用领域。

✨ 新功能

🎉 生产就绪：所有33个工具均完全可用，成功率为100% 🔧 无错误：消除了所有“函数未定义”错误和API问题 📊 标准化输出：统一了所有搜索工具的响应格式 🚀 优化性能：增强了错误处理和响应时间 🔒 强化安全：全面的安全改进，安全评分为9/10 🛡️ 企业就绪：完整的安全文档和部署指南 🔄 CI/CD集成：自动安全扫描和维护 📋 合规性：OWASP安全标准和最佳实践

🛠️ 33种专用工具

🎓 学术研究（7个工具）

search_arxiv：搜索arXiv预印本，包含详细论文信息
search_pubmed：使用NCBI E-utilities API进行医学文献搜索
search_ieee：IEEE Xplore工程和技术论文
search_semantic_scholar：AI增强的学术搜索，附带引用分析
search_iacr：密码学和信息安全研究
search_biorxiv：生物学预印本和最新研究
search_medrxiv：医学预印本和临床研究

💻 开发者工具（4个工具）

search_github：GitHub仓库、代码和问题搜索
search_stackoverflow：编程问答和技术解决方案
search_gitlab：GitLab项目和仓库搜索
search_bitbucket：Bitbucket仓库和代码搜索

🔍 隐私保护搜索（4个工具）

search_searx：具有隐私保护的元搜索引擎
search_startpage：隐私保护的网络搜索
search_brave：独立搜索引擎结果
search_ecosia：环保搜索支持植树造林

🧪 测试与开发（2个工具）

test_jsonplaceholder：JSON API测试和验证
test_httpbin：HTTP请求/响应测试

🕷️ 网页爬取（2个工具）

crawl_url_content：单页面内容提取
batch_crawl_urls：批量网站内容分析

📄 文档处理（1个工具）

analyze_pdf：PDF文档分析和内容提取

🧠 智能研究（5个工具）

intelligent_research：多源综合研究
deep_research：迭代深入研究，多个数据源
visualize_thinking：研究过程可视化（思维导图、流程图）
decompose_thinking：复杂问题分解和分析
check_research_saturation：研究完整性评估

💰 金融工具（8个工具）*

Alpha Vantage集成：

alpha_vantage_symbol_search：搜索股票代码和公司信息
alpha_vantage_stock_quote：获取实时股票报价和价格信息
alpha_vantage_intraday_data：获取指定间隔的日内股票价格数据
alpha_vantage_daily_data：获取每日股票价格数据和历史趋势
alpha_vantage_company_overview：获取全面的公司概况和基础信息
alpha_vantage_forex_rate：获取实时和历史外汇汇率
alpha_vantage_crypto_price：获取加密货币价格和市场数据
alpha_vantage_market_news：获取金融市场新闻和情绪分析

注意：金融工具需要API密钥，并可能有使用限制

🔒 安全特性

Open Search MCP实现了企业级安全措施：

🛡️ 安全亮点

🔐 安全API密钥管理：基于环境变量的密钥存储和验证
🔍 输入验证：使用Zod模式进行全面的输入净化和验证
🐳 容器安全：加固的Docker容器，非root用户和只读文件系统
📊 安全监控：自动安全扫描和漏洞检测
🔄 CI/CD安全：开发工作流中的集成安全检查
📋 合规性：实现OWASP安全标准和最佳实践

🚨 安全评分：9/10

✅ 无硬编码的秘密 - 所有API密钥安全存储
✅ 输入验证 - 防止注入攻击
✅ 容器加固 - 安全的Docker部署
✅ 依赖项扫描 - 自动漏洞检测
✅ 安全文档 - 全面的安全指南

📚 安全文档

安全策略 - 漏洞报告和安全指南
Docker安全 - 容器安全配置
安全部署 - 生产部署指南

🚀 快速开始

前提条件

Node.js 18+
Claude Desktop应用程序
TypeScript（用于开发）

安装

克隆仓库

git clone https://github.com/flyanima/open-search-mcp.git
cd open-search-mcp

安装依赖

npm install

运行安全检查（推荐）

npm run security:check

构建项目

npm run build

配置环境变量（安全方法）

# 复制模板并配置您的API密钥
cp .env.template .env
# 编辑.env文件以添加实际API密钥（不要提交此文件）
nano .env

配置Claude Desktop

复制claude_desktop_config.template.json并更新路径：

{
  "mcpServers": {
    "open-search-mcp": {
      "command": "node",
      "args": ["path/to/open-search-mcp/dist/index.js"],
      "env": {
        "NODE_ENV": "production",
        "FILTER_TO_README_33": "true",
        "GITHUB_TOKEN": "your_github_token_optional",
        "ALPHA_VANTAGE_API_KEY": "your_alpha_vantage_key_optional"
      }
    }
  }
}

重启Claude Desktop

33个工具将在您的Claude Desktop界面中可用。

配置位置

Windows：%APPDATA%\Claude\claude_desktop_config.json
macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Linux：~/.config/Claude/claude_desktop_config.json

💡 使用示例

学术研究

"在arXiv上搜索最近的机器学习论文"
"查找关于COVID-19治疗的PubMed文章"
"在IACR上查找密码学研究"

开发者工作流

"在GitHub上查找React组件"
"在Stack Overflow上搜索Python调试技巧"
"查找使用Docker的GitLab项目"

综合研究

"对量子计算进行智能研究"
"分析当前可再生能源技术的状态"
"可视化我解决这个复杂问题的过程"

内容分析

"爬取并分析该网站的内容"
"从这份PDF文档中提取信息"
"批量分析这些URL的共同主题"

🔧 API密钥及安全配置

🔒 安全API密钥管理

重要：切勿在配置中硬编码API密钥。使用环境变量进行安全配置。

金融工具所需

Alpha Vantage：免费层级可在alphavantage.co获得

可选增强功能

GitHub Token：用于更高的速率限制
Google Custom Search：作为备份搜索功能

🛡️ 安全配置方法

方法1：环境变量（推荐）

# 设置环境变量
export ALPHA_VANTAGE_API_KEY="your_key_here"
export GITHUB_TOKEN="your_token_here"

# 然后在Claude Desktop配置中使用，不暴露密钥
{
  "mcpServers": {
    "open-search-mcp": {
      "command": "node",
      "args": ["path/to/dist/expanded-server.js"]
    }
  }
}

方法2：.env文件（本地开发）

# 创建.env文件（自动被git忽略）
echo "ALPHA_VANTAGE_API_KEY=your_key_here" >> .env
echo "GITHUB_TOKEN=your_token_here" >> .env

方法3：Claude Desktop环境（不太安全）

{
  "mcpServers": {
    "open-search-mcp": {
      "command": "node",
      "args": ["path/to/dist/expanded-server.js"],
      "env": {
        "ALPHA_VANTAGE_API_KEY": "your_key_here",
        "GITHUB_TOKEN": "your_token_here"
      }
    }
  }
}

🔍 API密钥验证

# 验证您的API密钥配置
npm run security:scan

🏗️ 开发

前提条件

Node.js ≥ 18.0.0
npm ≥ 9.0.0
TypeScript
Git（带有预提交钩子）

设置

# 克隆仓库
git clone https://github.com/flyanima/open-search-mcp.git
cd open-search-mcp

# 安装依赖（包括安全工具）
npm install

# 设置预提交钩子进行安全检查
npm run prepare

# 运行安全检查
npm run security:check

# 构建项目
npm run build

# 运行测试
npm test

🔒 安全开发工作流

# 在提交前 - 自动安全检查
git add .
git commit -m "您的更改"  # 预提交钩子会自动运行

# 手动安全检查
npm run security:lint          # 安全聚焦的linting
npm run security:scan          # 全面的安全扫描
npm run security:maintenance   # 依赖项更新和维护

项目结构

src/
├── index.ts              # 主MCP服务器入口点
├── tools/                # 单个工具实现
├── utils/                # 工具函数和辅助程序
├── config/               # 配置管理
├── engines/              # 搜索引擎适配器
├── research/             # 研究和分析工具
└── types/                # TypeScript类型定义

dist/
├── expanded-server.js    # 编译的33个工具服务器
└── index.js              # 主编译服务器

🧪 测试与安全验证

全面测试

# 运行所有测试，包括安全测试
npm test

# 测试单独的工具
npm run test:tools

# 测试特定工具类别
npm run test:academic
npm run test:developer
npm run test:research

🔒 安全测试

# 全面的安全扫描
npm run security:scan

# 安全聚焦的linting
npm run security:lint

# 依赖项漏洞检查
npm run security:audit

# 完整的安全验证
npm run security:check

手动测试

# 在调试模式下启动服务器
node dist/expanded-server.js

# 使用MCP客户端测试
npx @modelcontextprotocol/inspector dist/expanded-server.js

# 开发中的安全验证
NODE_ENV=development npm run security:scan

🤝 贡献

我们欢迎贡献！以下是您可以帮助的方式：

开发工作流

分叉仓库
创建功能分支（git checkout -b feature/amazing-feature）
进行更改
为新功能添加测试
运行安全检查（npm run security:check）
确保所有测试通过（npm test）
验证没有安全问题（预提交钩子会自动运行）
提交更改（git commit -m '添加精彩功能'）
推送到分支（git push origin feature/amazing-feature）
打开拉取请求

🔒 贡献者的安全要求

✅ 所有安全检查必须通过
✅ 不要硬编码API密钥或秘密
✅ 新功能的输入验证
✅ 新工具的安全文档
✅ 遵循安全编码实践

贡献领域

🔍 新的搜索工具：增加对额外学术数据库或搜索引擎的支持
🧠 研究功能：增强智能研究能力
🐛 错误修复：帮助识别和修复问题
📚 文档：改进文档和示例
🧪 测试：增加更全面的测试
🔒 安全：增强安全特性和文档

📊 工具状态及安全

所有33个工具都已准备好生产使用，成功率为100%，具备企业级安全：

🛠️ 工具功能

✅ 学术搜索：7/7工具正常工作
✅ 开发者工具：4/4工具正常工作
✅ 搜索引擎：4/4工具正常工作
✅ 测试工具：2/2工具正常工作
✅ 网页爬取：2/2工具正常工作
✅ 文档处理：1/1工具正常工作
✅ 研究分析：5/5工具正常工作
⚠️ 金融工具：8/8工具（需要API密钥）

🔒 安全状态

✅ 输入验证：所有工具使用严格的输入验证
✅ API密钥安全：安全的环境变量管理
✅ 容器安全：加固的Docker部署
✅ 依赖项安全：定期漏洞扫描
✅ 代码安全：安全聚焦的linting和分析
✅ 文档：全面的安全指南
✅ CI/CD安全：自动安全检查

📈 安全指标

总体安全评分：9/10
漏洞数量：0个关键，0个高危
安全覆盖率：100%的工具经过验证
合规性：实施OWASP标准

📄 许可证

本项目采用MIT许可证 - 查看LICENSE文件了解详情。

🙏 致谢

免费API：感谢arXiv、PubMed、GitHub等服务提供的免费访问
MCP协议：基于Anthropic的模型上下文协议构建
开源社区：受到开源协作精神的启发

📞 支持

一般支持

🐛 问题：GitHub问题
💬 讨论：GitHub讨论
📖 文档：查看docs/目录中的详细指南

🔒 安全支持

🚨 安全问题：使用GitHub安全公告报告漏洞
📋 安全政策：查看SECURITY.md了解报告指南
🛡️ 安全文档：

📚 额外资源

🔧 安全工具：运行npm run security:scan进行健康检查
📊 安全报告：CI/CD中的自动化安全扫描
🔄 维护：使用npm run security:maintenance进行更新

🔗 相关项目

模型上下文协议 - 本服务器实现的协议
Claude Desktop - 本MCP服务器的主要客户端
MCP SDK - 官方MCP开发工具

🔍 Open Search MCP - 通过全面的搜索能力赋能研究

为研究和开发者社区制作 ❤️