AIsa-mcp-server 是一个 MCP（Model Context Protocol）服务器，旨在将 AIsa 的数据 API 以工具形式提供给 AI 代理。其核心设计是：不直接暴露数百个工具，而是通过五个元工具来搜索、检查和调用整个目录，从而节省上下文窗口。
用途
该服务器用于让 AI 代理访问多种数据 API，涵盖 SEO 和 AI 可见性、金融、社交、网络搜索、销售和代理邮件等领域。它适合需要动态发现和调用外部数据服务的代理场景，例如市场调研、竞争分析、销售线索生成等。
主要能力
- 提供 580+ 工具，分布在 26 个服务器中。
- 通过五个元工具访问：search（搜索工具）、get_details（获取工具详情）、list_categories（列出分类）、use（调用工具）、batch_use（批量调用工具）。
- 支持 Streamable HTTP 传输，单一 URL 即可连接。
- 支持 OAuth 授权，无需预先创建账户；也支持使用 API 密钥（Bearer Token）进行认证。
- 提供 stdio 桥接包 @aisa-one/mcp，供仅支持 stdio 的客户端（如 Claude Desktop）使用。
- 支持按分类固定（pinning），每个分类路径仍保留五个元工具和价格上限。
- 每次调用可设置 max_price_usd，超出预算的调用会被拒绝，避免意外费用。
使用方式
- 对于支持远程 MCP 的客户端（如 Cursor、VS Code、Windsurf），在 MCP 设置中添加 URL：
https://mcp.aisa.one/mcp，传输方式为 streamable-http。 - 授权采用 OAuth：未认证调用会返回 401 和 WWW-Authenticate 头，指向
https://mcp.aisa.one/.well-known/oauth-protected-resource/mcp，客户端可自动注册并打开浏览器完成授权。 - 如果已有 API 密钥（来自 console.aisa.one），可在请求头中发送
Authorization: Bearer $AISA_API_KEY，无需浏览器授权，适合 SSH 或 CI 环境。 - 对于仅支持 stdio 的客户端，使用包 @aisa-one/mcp 作为本地命令，它会桥接到远程端点，并在首次使用时运行 OAuth 浏览器流程并缓存令牌。环境变量 AISA_API_KEY 会被自动识别。
- 可通过固定分类路径来限制 tools/list 返回的工具范围，但不会影响可访问性。
适用场景
- AI 代理需要动态发现和调用多种数据 API 时。
- 需要控制成本，避免代理意外调用高费用工具。
- 在无法使用浏览器授权的环境（如 SSH、CI）中，通过 API 密钥访问。
- 使用仅支持 stdio 的 MCP 客户端（如 Claude Desktop）时。
限制
- 搜索、获取详情和列出分类免费；use 和 batch_use 按调用计费，价格与 AIsa REST API 相同，无座位费和月最低消费。
- 调用可能因余额不足或缺少 Hive GTM Growth 订阅而返回 402 错误。
- 工具数量和分类可能随目录变化，实时信息可查看
mcp.aisa.one/servers。 - 该仓库主要提供 stdio 桥接，大多数客户端可直接使用远程 URL，无需此包。
- 更多信息可参考
mcp.aisa.one/llms.txt、mcp.aisa.one/servers、mcp.aisa.one/.well-known/mcp/server-card.json以及aisa.one/mcp。
