Litefuse MCP Server

Litefuse 内置一个原生的 Model Context Protocol（MCP）server，让 AI 助手与 agent 能够以编程方式与你的 Litefuse 数据交互。

目前，MCP server 已支持 Prompt Management，未来会扩展到 Litefuse 数据平台的其余部分。如果你有反馈或新工具的想法，请提交 issue。

这是用于 Litefuse 数据平台的需要认证的 MCP server。另外还有一个用于 Litefuse 文档的公共 MCP server（文档）。

配置

Litefuse MCP server 采用无状态架构，每个 API Key 都被限定在一个具体项目内。使用以下配置连接到 MCP server：

Endpoint: https://litefuse.cloud/api/public/mcp
Transport: streamableHttp
认证：通过 authorization header 进行 Basic Auth

Endpoint: https://litefuse.cloud/api/public/mcp
Transport: streamableHttp
认证：通过 authorization header 进行 Basic Auth

Endpoint: https://hipaa.cloud.litefuse.ai/api/public/mcp
Transport: streamableHttp
认证：通过 authorization header 进行 Basic Auth

Endpoint: https://your-domain.com/api/public/mcp
Transport: streamableHttp
认证：通过 authorization header 进行 Basic Auth

可用工具

MCP server 提供五个工具，覆盖完整的 prompt 管理能力。

⚠️

读和写工具默认都可用。 如果你只想使用只读工具，请在 MCP 客户端中配置 allowlist，限制对写操作（createTextPrompt、createChatPrompt、 updatePromptLabels）的访问。

读操作

getPrompt —— 按名称获取特定 prompt，可选 label 或版本
- 支持按 production/staging label 过滤
- 返回带 metadata 的编译后 prompt
- 只读操作（客户端会自动批准）
listPrompts —— 列出项目中的所有 prompt
- 可选按 name、tag 或 label 过滤
- 支持基于 cursor 的分页
- 返回 prompt 的 metadata 和可用版本

写操作

createTextPrompt —— 创建一个新的文本 prompt 版本
- 支持使用 {{variable}} 语法的模板变量
- 可选的 labels、config、tags 与 commit 信息
- 自动递增版本号
createChatPrompt —— 创建一个新的 chat prompt 版本
- OpenAI 风格的消息格式（role + content）
- 支持 system、user 与 assistant 角色
- 消息内容中可使用模板变量
updatePromptLabels —— 管理跨 prompt 版本的 label
- 在版本之间添加或移动 label
- label 是唯一的（会自动从其他版本中移除）
- 不能修改自动管理的 latest label

配置步骤

获取认证 Header

进入项目设置，创建或复制一个 限定项目范围的 API Key：
- Public Key: pk-lf-...
- Secret Key: sk-lf-...

将凭据编码为 base64 格式：

your-base64-token

echo -n "pk-lf-your-public-key:sk-lf-your-secret-key" | base64

客户端配置

通过单条命令注册 Litefuse MCP server，将 {your-base64-token} 替换为你编码后的凭据：

terminal

# Litefuse Cloud
claude mcp add --transport http litefuse https://litefuse.cloud/api/public/mcp \
    --header "Authorization: Basic {your-base64-token}"
 
# Self-Hosted (HTTPS required)
claude mcp add --transport http litefuse https://your-domain.com/api/public/mcp \
    --header "Authorization: Basic {your-base64-token}"
 
# Local Development
claude mcp add --transport http litefuse http://localhost:3000/api/public/mcp \
    --header "Authorization: Basic {your-base64-token}"

让 Claude Code list all prompts in the project 来验证连接。Claude Code 应当使用 listPrompts 工具返回 prompt 列表。

打开 Cursor 设置（Cmd/Ctrl + Shift + J）
进入 Tools & Integrations 标签页
点击 “Add Custom MCP”
添加你的 Litefuse MCP server 配置，将 {your-base64-token} 替换为你编码后的凭据：

mcp.json

{
  "mcp": {
    "servers": {
      "langfuse": {
        "url": "https://litefuse.cloud/api/public/mcp",
        "headers": {
          "Authorization": "Basic {your-base64-token}"
        }
      }
    }
  }
}

mcp.json

{
  "mcp": {
    "servers": {
      "langfuse": {
        "url": "https://litefuse.cloud/api/public/mcp",
        "headers": {
          "Authorization": "Basic {your-base64-token}"
        }
      }
    }
  }
}

mcp.json

{
  "mcp": {
    "servers": {
      "langfuse": {
        "url": "https://hipaa.cloud.litefuse.ai/api/public/mcp",
        "headers": {
          "Authorization": "Basic {your-base64-token}"
        }
      }
    }
  }
}

mcp.json

{
  "mcp": {
    "servers": {
      "langfuse": {
        "url": "https://your-domain.com/api/public/mcp",
        "headers": {
          "Authorization": "Basic {your-base64-token}"
        }
      }
    }
  }
}

保存文件并重启 Cursor
server 应当出现在 MCP 设置中，并以绿色圆点表示已激活

Endpoint: /api/public/mcp
- EU: https://litefuse.cloud/api/public/mcp
- US: https://litefuse.cloud/api/public/mcp
- HIPAA: https://hipaa.cloud.litefuse.ai/api/public/mcp
- Self-Hosted: https://your-domain.com/api/public/mcp
Transport: streamableHttp
认证：通过 authorization header 进行 Basic Auth
- Authorization: Basic {your-base64-token}

使用场景

MCP server 为 AI 辅助的 prompt 管理带来了强大的工作流：

Prompt 创建：“为客服创建一个新的 chat prompt，包含 system 指令和示例消息”
版本管理：“将 staging label 指向 email-generation prompt 的第 3 版”
Prompt 发现：“列出所有打了 ‘production’ tag 的 prompt 并展示它们的最新版本”
迭代开发：“为 code-review prompt 创建一个改进过指令的新版本”

反馈

我们非常希望听到你使用 Litefuse MCP server 的体验。请通过提交 issue 分享你的反馈、想法和使用场景。

Litefuse MCP Server

配置

可用工具

读操作

写操作

配置步骤

获取认证 Header

客户端配置

使用场景

反馈

相关文档