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

pip install -r requirements.txt

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

python server.py

python test_all_scopes.py

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

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

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

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

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

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

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                     # 项目说明

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

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

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