LangSmith MCP 服务器

​

示例用例

• 对话历史：“从项目 ‘my-chatbot’ 中的线程 ‘thread-123’ 获取我的对话历史”
• 提示词管理：“获取所有公开提示词”或“拉取 ‘legal-case-summarizer’ 提示词的模板”
• 追踪和运行记录：“从项目 ‘alpha’ 获取最新的 10 个根运行记录”或“通过 UUID 获取某个追踪的所有运行记录”
• 数据集：“列出类型为 chat 的数据集”或“从数据集 ‘customer-support-qa’ 读取示例”
• 实验：“列出数据集 ‘my-eval-set’ 的实验，包含延迟和成本指标”
• 账单：“获取 2025 年 9 月的账单使用情况”

​

快速入门（托管版）

• URL: https://langsmith-mcp-server.onrender.com/mcp
• 身份验证： 在 LANGSMITH-API-KEY 请求头中发送您的 LangSmith API 密钥。

{
  "mcpServers": {
    "LangSmith MCP (Hosted)": {
      "url": "https://langsmith-mcp-server.onrender.com/mcp",
      "headers": {
        "LANGSMITH-API-KEY": "lsv2_pt_your_api_key_here"
      }
    }
  }
}

​

可用工具

​

对话和线程

​

提示词管理

​

追踪和运行记录

​

数据集和示例

​

实验和评估

​

账单

​

分页（基于字符）

• 使用工具： get_thread_history 和 fetch_runs（当设置了 trace_id 时）。
• 参数： 每次请求发送 page_number（从 1 开始）。可选：max_chars_per_page（默认 25000，最大 30000）、preview_chars（使用 ”… (+N chars)” 截断长字符串）。
• 响应： 包含 page_number、total_pages 和页面负载。通过再次调用 page_number = 2，然后 3，直到 total_pages 来请求更多页面。
• 优点： 页面按字符数而非项目数构建；无需游标或服务器端状态——只需页码。

​

安装（本地运行）

​

先决条件

1. 安装 uv（Python 包安装器）：
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
2. 安装包：
   uv run pip install --upgrade langsmith-mcp-server
   

​

MCP 客户端配置

{
  "mcpServers": {
    "LangSmith API MCP Server": {
      "command": "/path/to/uvx",
      "args": ["langsmith-mcp-server"],
      "env": {
        "LANGSMITH_API_KEY": "your_langsmith_api_key",
        "LANGSMITH_WORKSPACE_ID": "your_workspace_id",
        "LANGSMITH_ENDPOINT": "https://api.smith.langchain.com"
      }
    }
  }
}

{
  "mcpServers": {
    "LangSmith API MCP Server": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/path/to/langsmith-mcp-server",
        "run",
        "langsmith_mcp_server/server.py"
      ],
      "env": {
        "LANGSMITH_API_KEY": "your_langsmith_api_key",
        "LANGSMITH_WORKSPACE_ID": "your_workspace_id",
        "LANGSMITH_ENDPOINT": "https://api.smith.langchain.com"
      }
    }
  }
}

​

Docker 部署（HTTP 可流式传输）

1. 构建并运行：
   docker build -t langsmith-mcp-server .
   docker run -p 8000:8000 langsmith-mcp-server
   
   使用 langsmith-mcp-server 仓库获取 Dockerfile 和上下文。
2. 将您的 MCP 客户端连接到 http://localhost:8000/mcp，并提供 LANGSMITH-API-KEY 请求头（以及可选的 LANGSMITH-WORKSPACE-ID、LANGSMITH-ENDPOINT）。
3. 健康检查（无需身份验证）：
   curl http://localhost:8000/health
   

​

部署概述

​

环境变量

​

TypeScript 实现