秘塔搜索

MCP Metaso

MCP (Model Context Protocol) に基づく 秘塔 AI 搜索引擎 サーバーです。公式 FastMCP SDK を使用して構築されています。

✨ 機能

• 🔍 多次元検索：ウェブ、文庫、学術、画像、動画、ポッドキャストの6種類の検索に対応
• 📄 ウェブページ解析：ウェブページのコンテンツを抽出し、Markdown または JSON 形式に変換します
• ⚡ 高性能：FastMCP SDK に基づき、非同期処理と型安全性を備えています
• 🔌 標準準拠：MCP プロトコル仕様に完全準拠しており、Claude Desktop などのクライアントと統合できます

🚀 クイックスタート

依存関係のインストール

Smithery 経由でインストール

Smithery 経由で mcp-metaso を Claude Desktop に自動インストールするには：

npx -y @smithery/cli install @HundunOnline/mcp-metaso --client claude

手動インストール

pip install -r requirements.txt

API キーの設定

export METASO_API_KEY="your-api-key-here"

サーバーの起動

python server.py

機能のテスト

python test_all_scopes.py

🔧 Claude Desktop との統合

DXT 拡張機能のインストール（最も簡単な方法）🌟

Claude Desktop は DXT 拡張機能形式に対応しているため、ブラウザー拡張機能をインストールするように簡単にインストールできます！

1. DXT 拡張機能ファイルをダウンロード

   • リリースページから mcp-metaso-1.1.0.dxt をダウンロードします

2. ダブルクリックしてインストール

   • Claude Desktop アプリを開きます
   • 設定 > 拡張機能に移動します
   • 「.dxt ファイルからインストール」をクリックし、ダウンロードしたファイルを選択します
   • 設定画面で Metaso API キーを入力します
   • 「インストール」をクリックして完了します

3. すぐに使用

   • Claude Desktop を再起動します
   • 「人工知能の最新動向を検索して」と入力して使用を開始します

自動インストールツール（従来の方法）

従来のインストール方法をお好みの場合：

# 自动安装到Claude Desktop
python tools/install_claude.py

# 或使用配置生成器
python tools/claude_config_generator.py --save

手動設定

Claude Desktop の設定ファイルに以下を追加します：

{
  "mcpServers": {
    "mcp-metaso": {
      "command": "python",
      "args": ["/path/to/mcp-metaso/server.py"],
      "env": {
        "METASO_API_KEY": "your-api-key-here"
      }
    }
  }
}

設定ファイルの場所：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

設定の確認

インストール後、設定が正しいことを確認します：

# 验证MCP服务器配置
python tools/validate_config.py

# 生成诊断报告
python tools/validate_config.py --report

トラブルシューティング

Claude Desktop に🔨アイコンが表示されない場合：

1. Claude Desktop を再起動 - 設定の変更を反映するにはアプリの再起動が必要です
2. パスを確認 - server.py を指す絶対パスを使用していることを確認します
3. API キーを確認 - METASO_API_KEY が正しく設定されていることを確認します
4. ログを確認 - Claude Desktop のログフォルダーでエラーメッセージを確認します

よく使うツールコマンド：

# 生成配置
python tools/claude_config_generator.py --api-key your_key --save

# 自动安装
python tools/install_claude.py --auto-confirm

# 卸载服务器
python tools/install_claude.py --uninstall

# 验证配置
python tools/validate_config.py

# 使用启动包装器
python tools/launcher.py

📖 利用可能なツール

metaso_search

6種類の検索に対応する多次元検索ツール：

metaso_search(
    query="人工智能发展趋势",  # 搜索查询词
    scope="webpage",           # 搜索类型：webpage/document/scholar/image/video/podcast
    include_summary=False,     # 是否包含 AI 摘要
    size=10                   # 结果数量 (1-20)
)

検索タイプの説明：

• webpage - ウェブページ検索：ニュース、ブログ、情報
• document - 文庫検索：PDF 文書、技術文書
• scholar - 学術検索：論文、研究文献
• image - 画像検索：画像、グラフ、イラスト
• video - 動画検索：チュートリアル、講演、エンターテインメントコンテンツ
• podcast - ポッドキャスト検索：音声番組、インタビュー

metaso_reader

ウェブページコンテンツ解析ツール：

metaso_reader(
    url="https://example.com",  # 网页 URL
    output_format="markdown"    # 输出格式：markdown/json
)

📁 プロジェクト構成

mcp-metaso/
├── server.py                      # 主服务器实现 (FastMCP)
├── config.py                      # 配置管理
├── tools/                         # Claude Desktop集成工具
│   ├── __init__.py               # 工具包初始化
│   ├── claude_config_generator.py # Claude配置生成器
│   ├── install_claude.py         # 自动安装脚本
│   ├── validate_config.py        # 配置验证工具
│   └── launcher.py               # 启动包装器
├── test_all_scopes.py            # 功能测试脚本
├── requirements.txt              # 项目依赖
├── setup.py                      # 包安装配置
└── README.md                     # 项目说明

🔨 開発

動作環境

• Python 3.10+
• Metaso API Key

ローカル開発

1. プロジェクトをクローンします：

   git clone https://github.com/HundunOnline/mcp-metaso
   cd mcp-metaso
   

2. 依存関係をインストールします：

   pip install -r requirements.txt
   

3. 環境変数を設定します：

   export METASO_API_KEY="your-key"
   

4. テストを実行します：

   python test_all_scopes.py
   

DXT 拡張機能のカスタマイズ

開発者は DXT 拡張機能パッケージをカスタマイズできます：

# 构建DXT扩展包
python build-dxt.py

# 这将生成：
# - mcp-metaso-1.1.0.dxt (扩展包)
# - DXT安装指南.md (用户安装说明)

新機能の追加

FastMCP デコレーターを使うと、新しいツールを簡単に追加できます：

@mcp.tool()
async def new_tool(param: str) -> str:
    """新工具描述
    
    Args:
        param: 参数描述
    """
    # 实现逻辑
    return result

📄 ライセンス

本プロジェクトは MIT ライセンスを採用しています。

🤝 貢献

Issue や Pull Request の投稿を歓迎します！

🔗 関連リンク

• MCP 公式ドキュメント
• FastMCP SDK
• Metaso AI