LangSmith MCP服务器（TypeScript）
示例用例
该服务器支持强大的功能，包括：
- 对话历史：“从项目‘我的聊天机器人’中的线程‘thread-123’获取我的对话历史”（按角色预算分页）
- 及时管理：“在我的工作区中获取所有公开提示”/“提取“法律案件摘要”提示的模板”
- 痕迹与奔跑：“从项目'alpha'获取最近10次根运行”/“获取跟踪\的所有运行（第2页，共5页）”
- 数据集：“列出聊天类型的数据集”/“从‘客户支持质量保证’数据集中阅读示例”
- 实验：“列出数据集‘我的评估集’的实验，包括延迟和成本指标”
- 计费：“获取2025年9月的账单使用情况”
快速开始
LANGSMITH_API_KEY=your-key npx langsmith-mcp-server可用工具
LangSmith MCP服务器提供以下工具与LangSmith集成。
对话与话题
| 工具名称 | 描述 |
|---|---|
get_thread_history | 检索对话线程的消息历史记录。用途 基于char的分页：通过 page_number （基于1），并返回use total_pages 请求更多页面。可选的 max_chars_per_page 和 preview_chars 控制页面大小和长字符串截断。 |
及时管理
| 工具名称 | 描述 |
|---|---|
list_prompts | 通过可选的可见性（公共/私有）和限制过滤从LangSmith获取提示。 |
get_prompt_by_name | 按确切名称获取特定提示，返回提示详细信息和模板。 |
push_prompt | 仅限文档：如何创建提示并将其推送到LangSmith。 |
痕迹与奔跑
| 工具名称 | 描述 |
|---|---|
fetch_runs | 从一个或多个项目中获取LangSmith运行（跟踪、工具、链等）。支持过滤器（run_type、error、is_root）、FQL(filter, trace_filter, tree_filter)，并排序。所有结果均为 自动分页 按角色预算。总是通过 limit 和 page_number. |
list_projects | 列出LangSmith项目，并可选择按名称、数据集和详细程度进行过滤（简化与完整）。 |
数据集和示例
| 工具名称 | 描述 |
|---|---|
list_datasets | 通过按ID、类型、名称、名称子字符串或元数据进行筛选来获取数据集。 |
list_examples | 通过数据集ID/名称或示例ID从数据集中获取示例，包括过滤器、元数据、拆分和可选 as_of 版本。 |
read_dataset | 按ID或名称读取单个数据集。 |
read_example | 按ID读取单个示例，可选 as_of 版本。 |
create_dataset | 仅限文档：如何在LangSmith中创建数据集。 |
update_examples | 仅限文档：如何在LangSmith中更新数据集示例。 |
实验与评估
| 工具名称 | 描述 |
|---|---|
list_experiments | 列出数据集的实验项目（参考项目）。需要 reference_dataset_id 或 reference_dataset_name.返回关键指标（延迟、成本、反馈统计数据）。 |
run_experiment | 仅限文档：如何在LangSmith中运行实验和评估。 |
使用和计费
| 工具名称 | 描述 |
|---|---|
get_billing_usage | 获取某个日期范围内的组织计费使用情况（例如跟踪计数）。可选工作区过滤器；返回内联工作区名称的指标。 |
分页（基于字符）
使用多种工具 无状态字符预算分页 因此，响应保持在大小限制内，并与LLM客户端配合良好：
- 使用地点：
get_thread_history和fetch_runs. - 参数： 您发送
page_number（基于1）根据每个请求。可选：max_chars_per_page（默认25000，上限30000）以及preview_chars（用“…（+N个字符）”截断长字符串）。 - 答复： 每个响应包括
page_number,total_pages，以及页面有效负载(result对于消息，runs跑步）。要获取更多信息，请再次致电page_number = 2那么3，直到total_pages. - 为什么有用： 页面是由JSON字符数构建的，而不是项目数，因此每个页面都适合固定大小。没有游标或服务器端状态，只有整数页码。
安装
来自npm
npx langsmith-mcp-serverMCP客户端集成
光标/克劳德代码
添加到MCP设置中：
{
"mcpServers": {
"langsmith": {
"command": "npx",
"args": ["langsmith-mcp-server"],
"env": {
"LANGSMITH_API_KEY": "your-key"
}
}
}
}环境变量
| 变量 | 必填 | 描述 | 示例 |
|---|---|---|---|
LANGSMITH_API_KEY | 是 | 用于身份验证的LangSmith API密钥 | lsv2_pt_1234567890 |
LANGSMITH_WORKSPACE_ID | 没有 | 范围为多个工作区的API键的工作区ID | your_workspace_id |
LANGSMITH_ENDPOINT | 否 | 自定义API端点URL（适用于自托管或欧盟地区） | https://eu.api.smith.langchain.com |
笔记：
- 仅
LANGSMITH_API_KEY基本功能需要 LANGSMITH_WORKSPACE_ID当您的API密钥可以访问多个工作区时非常有用LANGSMITH_ENDPOINT允许您为自托管的LangSmith安装或欧盟地区使用自定义端点
发展与贡献
设置
# Clone the repository
git clone https://github.com/langchain-ai/langsmith-mcp-server-js.git
cd langsmith-mcp-server-js
# Install dependencies
npm install
# Build
npm run build
# Run in development mode
LANGSMITH_API_KEY=your-key npm run dev
# Run production build
LANGSMITH_API_KEY=your-key npm start测试
# Run unit tests
npm testMCP检查员
对于交互式开发和调试，请使用MCP检查器：
LANGSMITH_API_KEY=your-key npx @modelcontextprotocol/inspector npx .这将打开一个浏览器UI，您可以在其中浏览所有工具，检查它们的模式，并以交互方式调用它们。
验证服务器是否响应
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.1.0"}}}' | LANGSMITH_API_KEY=test npx . 2>/dev/null建筑
这是一个直达港口 Python LangSmith MCP服务器 具有相同的模块结构：
src/
index.ts # Entry point (stdio transport)
server.ts # McpServer setup
common/
helpers.ts # Client creation, data conversion utilities
pagination.ts # Char-based stateless pagination
formatters.ts # Message extraction and formatting
services/
register-tools.ts # MCP tool registration with Zod schemas
tools/
prompts.ts # Prompt management tools
traces.ts # Trace/run/project tools
datasets.ts # Dataset and example tools
experiments.ts # Experiment listing tools
usage.ts # Billing/usage REST API tools贡献
欢迎投稿！请在GitHub上打开问题或拉取请求。
许可证
该项目在MIT许可证下分发。有关详细的条款和条件，请参阅 许可证 文件。