Skip to main content
LangSmith MCP 服务器是一个模型上下文协议（MCP）服务器，它与 LangSmith 集成。它允许兼容 MCP 的客户端（例如，AI 编程助手）从您的 LangSmith 工作区读取对话历史、提示词、运行记录和追踪、数据集、实验以及账单使用情况。

​
示例用例

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

​
快速入门（托管版）

LangSmith MCP 服务器的托管版本可通过 HTTP 使用，因此您无需自己运行服务器即可连接。
  • URL: https://langsmith-mcp-server.onrender.com/mcp
  • 身份验证： 在 LANGSMITH-API-KEY 请求头中发送您的 LangSmith API 密钥。
托管实例适用于 LangSmith Cloud。对于自托管 LangSmith 实例，请自行运行服务器并将其指向您的端点（参见 Docker 部署）。
示例（Cursor mcp.json）： 
{
  "mcpServers": {
    "LangSmith MCP (Hosted)": {
      "url": "https://langsmith-mcp-server.onrender.com/mcp",
      "headers": {
        "LANGSMITH-API-KEY": "lsv2_pt_your_api_key_here"
      }
    }
  }
}
可选请求头：LANGSMITH-WORKSPACE-ID、LANGSMITH-ENDPOINT（与环境变量中的相同）。

​
可用工具

​
对话和线程

工具描述
get_thread_history获取对话线程的消息历史。使用基于字符的分页：传递 page_number（从 1 开始），并使用返回的 total_pages 来请求更多页面。可选：max_chars_per_page、preview_chars。

​
提示词管理

工具描述
list_prompts列出提示词，可按可见性（公开/私有）和数量限制进行可选过滤。
get_prompt_by_name通过精确名称获取单个提示词（详情和模板）。
push_prompt仅文档：如何创建提示词并将其推送到 LangSmith。

​
追踪和运行记录

工具描述
fetch_runs从一个或多个项目中获取运行记录（追踪、工具、链等）。支持过滤器（run_type、error、is_root）、FQL（filter、trace_filter、tree_filter）和排序。当设置了 trace_id 时，结果按字符分页；否则一次性返回最多 limit 条。始终传递 limit 和 page_number。
list_projects列出项目，可按名称、数据集和详细级别进行可选过滤。

​
数据集和示例

工具描述
list_datasets列出数据集，可按 ID、类型、名称或元数据进行过滤。
list_examples通过数据集 ID/名称或示例 ID 列出数据集中的示例；支持过滤器、元数据、分割和可选的 as_of 版本。
read_dataset通过 ID 或名称读取一个数据集。
read_example通过 ID 读取一个示例，可选 as_of 版本。
create_dataset仅文档：如何创建数据集。
update_examples仅文档：如何更新数据集示例。

​
实验和评估

工具描述
list_experiments列出数据集的实验（参考）项目。需要 reference_dataset_id 或 reference_dataset_name。返回指标（延迟、成本、反馈）。
run_experiment仅文档：如何运行实验和评估。

​
账单

工具描述
get_billing_usage获取组织在某个日期范围内的账单使用情况（例如追踪计数）。可选工作区过滤器。

​
分页（基于字符）

返回大型负载的工具使用基于字符预算的分页，以使响应保持在大小限制内：
  • 使用工具： 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 来请求更多页面。
  • 优点： 页面按字符数而非项目数构建；无需游标或服务器端状态——只需页码。

​
安装（本地运行）

如果您希望在本地运行服务器（或使用自托管的 LangSmith 端点），请安装它并配置您的 MCP 客户端。

​
先决条件

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

​
MCP 客户端配置

将服务器添加到您的 MCP 客户端配置中。使用 which uvx 的路径作为 command 的值。 PyPI / uvx： 
{
  "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"
      }
    }
  }
}
从源码（首先克隆 langsmith-mcp-server）： 
{
  "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"
      }
    }
  }
}
将 /path/to/uv、/path/to/uvx 和 /path/to/langsmith-mcp-server 替换为您的实际路径。

​
Docker 部署（HTTP 可流式传输）

您可以使用 Docker 将服务器作为 HTTP 服务运行，以便客户端通过 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
有关完整的 Docker 和 HTTP 可流式传输详情，请参阅 LangSmith MCP 服务器仓库。

​
部署概述

使用托管 MCP 服务器连接到 LangSmith Cloud（smith.langchain.com 或 eu.smith.langchain.com）。要连接到 Cloud 或自托管 LangSmith，请本地运行服务器并设置 LANGSMITH_ENDPOINT。对于自托管部署，您也可以通过 Docker 镜像在您的 VPC 内运行服务器。

​
环境变量

变量必需描述
LANGSMITH_API_KEY是用于身份验证的您的 LangSmith API 密钥。
LANGSMITH_WORKSPACE_ID否当您的 API 密钥有权访问多个工作区时的工作区 ID。
LANGSMITH_ENDPOINT否API 端点 URL（用于自托管或自定义区域）。默认值：https://api.smith.langchain.com。
对于托管服务器，使用与请求头相同的名称：LANGSMITH-API-KEY、LANGSMITH-WORKSPACE-ID、LANGSMITH-ENDPOINT。

​
TypeScript 实现

官方 Python 服务器有一个社区维护的 TypeScript/Node.js 移植版本可用。要运行它：LANGSMITH_API_KEY=your-key npx langsmith-mcp-server。 源码和包：GitHub · npm。由 amitrechavia 维护。
将这些文档通过 MCP 连接到 Claude、VSCode 等，以获取实时答案。
在 GitHub 上编辑此页面 或 提交问题。