Provides specific configuration instructions for integrating with Claude Desktop on macOS, including file path details for the configuration file.
Supports outputting parsed web content in Markdown format through the metaso_reader tool.
Utilizes Python as the runtime environment, requiring Python 3.10+ for operation of the MCP server.
Uses Shields.io badges in the README to display Python version, MCP version, and license information.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Metasosearch for recent AI developments in scholarly articles"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Metaso
一个基于 MCP (Model Context Protocol) 的 秘塔 AI 搜索引擎 服务器，使用官方 FastMCP SDK 构建。
✨ 功能特性
🔍 多维搜索：支持网页、文库、学术、图片、视频、播客六种搜索类型
📄 网页解析：提取网页内容并转换为 Markdown 或 JSON 格式
⚡ 高性能：基于 FastMCP SDK，异步处理，类型安全
🔌 标准兼容：完全符合 MCP 协议规范，可与 Claude Desktop 等客户端集成
Related MCP server: MCP Web Research Server
🚀 快速开始
安装依赖
Installing via Smithery
To install mcp-metaso for Claude Desktop automatically via Smithery:
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扩展格式，让安装变得像安装浏览器扩展一样简单！
下载DXT扩展文件
从发布页面下载
mcp-metaso-1.1.0.dxt
双击安装
打开Claude Desktop应用
导航到 设置 > 扩展
点击"从.dxt文件安装"并选择下载的文件
在配置界面输入您的Metaso API密钥
点击"安装"完成
立即使用
重启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.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
验证配置
安装完成后，验证配置是否正确：
# 验证MCP服务器配置
python tools/validate_config.py
# 生成诊断报告
python tools/validate_config.py --report故障排除
如果Claude Desktop没有显示🔨图标：
重启Claude Desktop - 配置更改需要重启应用
检查路径 - 确保使用绝对路径指向server.py
验证API密钥 - 确保METASO_API_KEY已正确设置
查看日志 - 检查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
本地开发
克隆项目：
git clone https://github.com/HundunOnline/mcp-metaso cd mcp-metaso安装依赖：
pip install -r requirements.txt设置环境变量：
export METASO_API_KEY="your-key"运行测试：
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！