Fluenta

Fluenta MCP 服务

远程 MCP 服务，基于六项实时市场信号为商业创意评分。通过 Claude、Cursor 或任何 MCP 客户端运行 Idea X-Ray，即可获得涵盖需求、痛点、竞争、变现、时机和分发的 Launch Readiness Score（LRS），还可搜索数千个已评分创意。

• 端点：https://fluenta.space/backend/api/v1/mcp（Streamable HTTP，JSON-RPC 2.0）
• 文档：fluenta.space/docs/api-and-mcp
• OpenAPI：openapi.json
• 网站：fluenta.space

此仓库包含注册清单（server.json）和集成说明。服务本身由 Fluenta 托管；无需在本地安装或运行任何内容。

工具

工具	功能
fluenta_idea_x-ray_sandbox	即时预览创意的 Launch Readiness Score（LRS）。不消耗额度，不写入数据。默认可先用它进行初步查看。
fluenta_idea_x-ray	完整的 X-Ray。基于六项实时信号为创意评分。排队时返回 xray_submitted，完成后返回 xray_result。
fluenta_search_ideas、fluenta_get_idea、fluenta_compare_ideas	搜索并比较已评分创意数据库。
fluenta_list_collections、fluenta_get_pipeline、fluenta_add_to_pipeline、fluenta_remove_from_pipeline	管理创意工作流。
fluenta_list_analyses、fluenta_list_xray_runs、fluenta_download_report	历史记录和报告。
fluenta_get_account、fluenta_get_usage	账户状态和用量。

身份验证

在 Fluenta 账户中创建 API 密钥（Settings, API keys）。密钥有两种权限范围：

• read：搜索创意、读取分析结果、列出合集、读取工作流和用量。
• read_write：包含 read 的所有权限，还可提交 X-Ray 分析并添加或移除工作流书签。

将密钥作为 Authorization: Bearer YOUR_FLUENTA_API_KEY 发送。

Claude Desktop

将以下内容添加到 claude_desktop_config.json 并重启 Claude：

{
  "mcpServers": {
    "fluenta": {
      "type": "http",
      "url": "https://fluenta.space/backend/api/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_FLUENTA_API_KEY" }
    }
  }
}

配置文件位置：macOS 上为 ~/Library/Application Support/Claude/，Windows 上为 %APPDATA%\Claude\。

Cursor

将相同的 JSON 添加到 ~/.cursor/mcp.json，或使用文档页面上的一键安装按钮。

Claude Code

claude mcp add --transport http fluenta https://fluenta.space/backend/api/v1/mcp --header "Authorization: Bearer YOUR_FLUENTA_API_KEY"

示例提示词

• “对以下创意运行沙盒 X-Ray：一项为餐厅菜单提供翻译服务的订阅服务。”
• “在 Fluenta 中搜索已评分的 AI 记账创意，并比较排名前三的创意。”
• “将最佳结果添加到我的工作流中。”

错误和限制

使用标准 HTTP 状态码。401 表示密钥无效或已撤销；402 表示额度不足或超出密钥限制；403 表示该操作所需的权限范围不匹配；429 表示请求受限（请遵循 Retry-After）。失败时的响应封装格式为 { "success": false, "error": { ... } }。

注册

此仓库中的 server.json 已将服务以 io.github.Fluenta-Team/fluenta 为标识发布到官方 MCP Registry。

许可证

此仓库的内容采用 MIT 许可证。托管服务的使用受 Fluenta 服务条款约束。