Open Search MCP

🚀 開放搜索MCP 🔍

開放搜索MCP是一個全面的模型上下文協議（MCP）服務器，為Claude桌面應用提供33種專業的研究和搜索工具。專為需要在學術、技術和通用領域具備強大搜索能力的研究人員、開發人員和知識工作者而設計。

🚀 快速開始

前提條件

• Node.js 18+
• Claude桌面應用程序
• TypeScript（用於開發）

安裝步驟

1. 克隆倉庫

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

2. 安裝依賴

npm install

3. 運行安全檢查（推薦）

npm run security:check

4. 構建項目

npm run build

5. 配置環境變量（安全方法）

# 複製模板並配置API密鑰
cp .env.template .env
# 使用實際的API密鑰編輯.env文件（切勿提交此文件）
nano .env

6. 配置Claude桌面應用

複製 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"
      }
    }
  }
}

7. 重啟Claude桌面應用

33種工具將在你的Claude桌面界面中可用。

配置文件位置

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

✨ 主要特性

🎉 最新特性

• 生產就緒：所有33種工具均完全可用，成功率達100%
• 無Bug：消除了所有“函數未定義”錯誤和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密鑰，且可能有使用限制

🔒 安全特性

🛡️ 安全亮點

• 🔐 安全的API密鑰管理：基於環境變量的密鑰存儲和驗證
• 🔍 輸入驗證：使用Zod模式進行全面的輸入清理和驗證
• 🐳 容器安全：使用非root用戶和只讀文件系統的加固Docker容器
• 📊 安全監控：自動化安全掃描和漏洞檢測
• 🔄 CI/CD安全：在開發工作流程中集成安全檢查
• 📋 合規性：實施OWASP安全標準和最佳實踐

🚨 安全評分：9/10

• ✅ 無硬編碼密鑰 - 所有API密鑰均安全存儲
• ✅ 輸入驗證 - 防止注入攻擊
• ✅ 容器加固 - 安全的Docker部署
• ✅ 依賴掃描 - 自動化漏洞檢測
• ✅ 安全文檔 - 全面的安全指南

📚 安全文檔

• 安全策略 - 漏洞報告和安全指南
• Docker安全 - 容器安全配置
• 安全部署 - 生產部署指南

💻 使用示例

學術研究

"Search for recent machine learning papers on arXiv"
"Find PubMed articles about COVID-19 treatments"
"Look up cryptography research in IACR"

開發工作流

"Find React components on GitHub"
"Search Stack Overflow for Python debugging tips"
"Look for GitLab projects using Docker"

綜合研究

"Perform intelligent research on quantum computing"
"Analyze the current state of renewable energy technology"
"Visualize my thinking process for this complex problem"

內容分析

"Crawl and analyze this website's content"
"Extract information from this PDF document"
"Batch analyze these URLs for common themes"

🔧 API密鑰與安全配置

🔒 安全的API密鑰管理

重要提示：切勿在配置中硬編碼API密鑰。為了安全起見，請使用環境變量。

金融工具所需

• Alpha Vantage：可在 alphavantage.co 獲取免費套餐

增強功能可選

• GitHub令牌：用於更高的速率限制
• Google自定義搜索：用於備用搜索功能

🛡️ 安全配置方法

方法1：環境變量（推薦）

# 設置環境變量
export ALPHA_VANTAGE_API_KEY="your_key_here"
export GITHUB_TOKEN="your_token_here"

# 然後在Claude桌面配置中使用，而不暴露密鑰
{
  "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桌面環境（安全性較低）

{
  "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 "Your changes"  # 預提交鉤子將自動運行

# 手動安全檢查
npm run security:lint          # 專注於安全的代碼檢查
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

# 專注於安全的代碼檢查
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

🤝 貢獻代碼

我們歡迎貢獻！以下是你可以提供幫助的方式：

開發工作流

1. 分叉倉庫
2. 創建一個功能分支 (git checkout -b feature/amazing-feature)
3. 進行更改
4. 為新功能添加測試
5. 運行安全檢查 (npm run security:check)
6. 確保所有測試通過 (npm test)
7. 驗證無安全問題（預提交鉤子將自動運行）
8. 提交更改 (git commit -m 'Add amazing feature')
9. 推送到分支 (git push origin feature/amazing-feature)
10. 打開一個拉取請求

🔒 貢獻者的安全要求

• ✅ 所有安全檢查必須通過
• ✅ 無硬編碼的API密鑰或機密信息
• ✅ 新功能需進行輸入驗證
• ✅ 為新工具提供安全文檔
• ✅ 遵循安全編碼實踐

貢獻領域

• 🔍 新搜索工具：添加對其他學術數據庫或搜索引擎的支持
• 🧠 研究功能：增強智能研究能力
• 🐛 Bug修復：幫助識別和修復問題
• 📚 文檔：改進文檔和示例
• 🧪 測試：添加更全面的測試
• 🔒 安全：增強安全功能和文檔

📊 工具狀態與安全

🛠️ 工具功能

• ✅ 學術搜索：7/7種工具正常工作
• ✅ 開發工具：4/4種工具正常工作
• ✅ 搜索引擎：4/4種工具正常工作
• ✅ 測試工具：2/2種工具正常工作
• ✅ 網頁爬取：2/2種工具正常工作
• ✅ 文檔處理：1/1種工具正常工作
• ✅ 研究分析：5/5種工具正常工作
• ⚠️ 金融工具：8/8種工具（需要API密鑰）

🔒 安全狀態

• ✅ 輸入驗證：所有工具均使用嚴格的輸入驗證
• ✅ API密鑰安全：安全的環境變量管理
• ✅ 容器安全：加固的Docker部署
• ✅ 依賴安全：定期進行漏洞掃描
• ✅ 代碼安全：專注於安全的代碼檢查和分析
• ✅ 文檔：全面的安全指南
• ✅ CI/CD安全：自動化安全檢查

📈 安全指標

• 整體安全評分：9/10
• 漏洞數量：0個關鍵漏洞，0個高危漏洞
• 安全覆蓋範圍：100%的工具經過驗證
• 合規性：實施了OWASP標準

📄 許可證

本項目採用MIT許可證 - 有關詳細信息，請參閱 LICENSE 文件。

🙏 致謝

• 免費API：感謝arXiv、PubMed、GitHub和其他提供免費訪問服務的平臺
• MCP協議：基於Anthropic的模型上下文協議構建
• 開源社區：受開源協作精神的啟發

📞 支持

一般支持

• 🐛 問題反饋：GitHub Issues
• 💬 討論交流：GitHub Discussions
• 📖 文檔查閱：請參閱 docs/ 目錄中的詳細指南

🔒 安全支持

• 🚨 安全問題：使用 GitHub Security Advisory 報告漏洞
• 📋 安全策略：請參閱 SECURITY.md 瞭解報告指南
• 🛡️ 安全文檔：
  • 安全策略
  • Docker安全
  • 安全部署

📚 額外資源

• 🔧 安全工具：運行 npm run security:scan 進行健康檢查
• 📊 安全報告：CI/CD中的自動化安全掃描
• 🔄 維護：使用 npm run security:maintenance 進行更新

🔗 相關項目

• Model Context Protocol - 此服務器實現的協議
• Claude Desktop - 此MCP服務器的主要客戶端
• MCP SDK - 官方MCP開發工具

🔍 開放搜索MCP - 通過全面的搜索功能賦能研究

為研究和開發社區用心打造 ❤️