MCP Metaso

一个基于 MCP (Model Context Protocol) 的 Metaso AI 搜索引擎服务器，使用官方 FastMCP SDK 构建。

✨ 功能特性

• 🔍 多维搜索：支持网页、文库、学术、图片、视频、播客六种搜索类型
• 📄 网页解析：提取网页内容并转换为 Markdown 或 JSON 格式
• ⚡ 高性能：基于 FastMCP SDK，异步处理，类型安全
• 🔌 标准兼容：完全符合 MCP 协议规范，可与 Claude Desktop 等客户端集成

🚀 快速开始

1. 安装依赖

pip install -r requirements.txt

2. 配置 API 密钥

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

3. 启动服务器

python server.py

4. 测试功能

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

多维搜索工具，支持六种搜索类型：

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 <repository-url>
   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