suanlinfang-mcp

算邻坊（suanlinfang.cn）AI 能力的 MCP Server：语音转文字、文字转语音、图片/PDF 文字识别、类型化智能决策，共 11 个工具，stdio / Streamable HTTP 双形态。

快速开始（本地 stdio）

pip install suanlinfang-mcp
export SUANLINFANG_API_KEY=nk-xxxx        # 控制台创建：https://suanlinfang.cn/consume-web/api-keys.html
suanlinfang-mcp

Claude Desktop / Cursor 配置（mcpServers）：

{
  "mcpServers": {
    "suanlinfang": {
      "command": "suanlinfang-mcp",
      "env": { "SUANLINFANG_API_KEY": "nk-xxxx" }
    }
  }
}

免安装方式（uv 自动拉包隔离运行）：

{
  "mcpServers": {
    "suanlinfang": {
      "command": "uvx",
      "args": ["suanlinfang-mcp"],
      "env": { "SUANLINFANG_API_KEY": "nk-xxxx" }
    }
  }
}

远程形态（免安装）

已提供常驻 Streamable HTTP 端点，支持远程 MCP 的客户端直接登记：

{
  "mcpServers": {
    "suanlinfang": {
      "url": "https://suanlinfang.cn/mcp",
      "headers": { "X-SLF-Api-Key": "nk-xxxx" }
    }
  }
}

自建 HTTP 形态：suanlinfang-mcp-http（监听 127.0.0.1:8090，端口用 SUANLINFANG_MCP_PORT 覆盖；HTTP 形态下每请求优先读请求头 X-SLF-Api-Key / Authorization: Bearer）。

工具清单（11 个）

STT 语音转文字（约 0.5 元/小时，按实际时长）

• transcribe_audio：短音频同步（≤3 分钟/20MB，公网 URL；热词 context、语种自动检测）
• submit_transcription_task / get_transcription_task：长音频任务（最长 2 小时/500MB，自动 180 秒切段拼接全文）

TTS 文字转语音（约 2 元/万字符）

• synthesize_speech：短文本同步（≤3000 字节，返回 1 小时有效的下载链接）
• submit_speech_task / get_speech_task：长文本任务（≤20 万字，500 字切块拼接）
• list_tts_voices：21 种音色清单

OCR 文字识别（约 0.5~1.5 分/页）

• recognize_image：单图同步（标准/精准双档位，精准档支持自定义 prompt）
• submit_document_task / get_document_task：PDF 任务（≤200MB/500 页）

DECISION 智能决策（约 2 元/百万输入 token，输出免费）

• decide：类型化判断（choice 多选一 / noul 是否 / score 等级打分），返回校准概率

异步任务统一三步：submit → 轮询 get（10~30 秒一次，看 doneUnits/totalUnits 进度）→ 终态取结果，终态保留 72 小时。所有产品失败不计费。

环境变量

新用户注册即赠 ¥10 体验金：https://suanlinfang.cn