Open Search MCP

🚀 Open Search MCP 🔍

Open Search MCPは、Claude Desktop向けに33の専用研究および検索ツールを提供する包括的なModel Context Protocol (MCP)サーバーです。学術、技術、一般ドメインにわたる強力な検索機能を必要とする研究者、開発者、知識労働者向けに設計されています。

🚀 クイックスタート

前提条件

• Node.js 18+
• Claude Desktopアプリケーション
• 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
# .envを実際のAPIキーで編集する (このファイルをコミットしないでください)
nano .env

6. 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"
      }
    }
  }
}

5. 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

✨ 主な機能

🎉 新機能

• 本番環境対応: すべての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コンテナです。
• 📊 セキュリティ監視: 自動化されたセキュリティスキャンと脆弱性検出です。
• 🔄 CI/CDセキュリティ: 開発ワークフローに統合されたセキュリティチェックです。
• 📋 コンプライアンス: OWASPセキュリティ標準とベストプラクティスの実装です。

🚨 セキュリティスコア: 9/10

• ✅ ハードコードされたシークレットがない - すべてのAPIキーが安全に保管されています。
• ✅ 入力検証 - インジェクション攻撃からの保護です。
• ✅ コンテナ強化 - 安全なDockerデプロイです。
• ✅ 依存関係スキャン - 自動化された脆弱性検出です。
• ✅ セキュリティドキュメント - 包括的なセキュリティガイドです。

📚 セキュリティドキュメント

• セキュリティポリシー - 脆弱性報告とセキュリティガイドラインです。
• Dockerセキュリティ - コンテナセキュリティの設定です。
• 安全なデプロイメント - 本番環境のデプロイメントガイドです。

💻 使用例

学術研究

"arXivで最近の機械学習論文を検索する"
"PubMedでCOVID-19の治療に関する記事を探す"
"IACRで暗号学の研究を調べる"

開発者ワークフロー

"GitHubでReactコンポーネントを探す"
"Stack OverflowでPythonのデバッグヒントを検索する"
"GitLabでDockerを使用しているプロジェクトを探す"

包括的な研究

"量子コンピューティングに関するインテリジェント研究を行う"
"再生可能エネルギー技術の現状を分析する"
"この複雑な問題の思考プロセスを可視化する"

コンテンツ分析

"このウェブサイトのコンテンツをクロールして分析する"
"このPDFドキュメントから情報を抽出する"
"これらのURLをバッチ分析して共通のテーマを見つける"

🔧 APIキーとセキュリティ設定

🔒 安全なAPIキー管理

重要: 設定にAPIキーをハードコードしないでください。セキュリティのために環境変数を使用してください。

金融ツールに必要なもの

• Alpha Vantage: alphavantage.coで無料の利用枠があります。

拡張機能にオプションのもの

• GitHubトークン: より高いレート制限のために使用します。
• 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 (pre-commitフック付き)

セットアップ

# リポジトリをクローンする
git clone https://github.com/flyanima/open-search-mcp.git
cd open-search-mcp

# 依存関係をインストールする (セキュリティツールを含む)
npm install

# セキュリティ用のpre-commitフックを設定する
npm run prepare

# セキュリティチェックを実行する
npm run security:check

# プロジェクトをビルドする
npm run build

# テストを実行する
npm test

🔒 セキュリティ開発ワークフロー

# コミットする前 - 自動セキュリティチェック
git add .
git commit -m "Your changes"  # Pre-commitフックが自動的に実行されます

# 手動セキュリティチェック
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. セキュリティ問題がないことを確認する (pre-commitフックが自動的に実行されます)
8. 変更をコミットする (git commit -m 'Add amazing feature')
9. ブランチにプッシュする (git push origin feature/amazing-feature)
10. プルリクエストを作成する

🔒 コントリビューターのセキュリティ要件

• ✅ すべてのセキュリティチェックが通過しなければなりません。
• ✅ ハードコードされたAPIキーやシークレットがないこと。
• ✅ 新機能の入力検証が行われること。
• ✅ 新ツールのセキュリティドキュメントが用意されること。
• ✅ 安全なコーディングプラクティスに従うこと。

コントリビューションの分野

• 🔍 新しい検索ツール: 追加の学術データベースや検索エンジンのサポートを追加する。
• 🧠 研究機能: インテリジェント研究機能を強化する。
• 🐛 バグ修正: 問題の特定と修正を支援する。
• 📚 ドキュメント: ドキュメントと例を改善する。
• 🧪 テスト: より包括的なテストを追加する。
• 🔒 セキュリティ: セキュリティ機能とドキュメントを強化する。

📊 ツールの状態とセキュリティ

すべての33のツールは、100%成功率で本番環境で使用可能であり、エンタープライズグレードのセキュリティを備えています。

🛠️ ツールの機能

• ✅ 学術検索: 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のModel Context Protocolをベースに構築されています。
• オープンソースコミュニティ: オープンソースの協調精神に触発されています。

📞 サポート

一般的なサポート

• 🐛 問題報告: 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開発ツール

🔍 Open Search MCP - 包括的な検索機能を通じて研究を強化する

研究者と開発者コミュニティのために愛情を込めて作られました