使用说明
象牙漂移MCP
MCP服务器，用于查询由 塔斯克漂流这使人工智能助手能够搜索、分析和调试应用程序的API流量，包括HTTP请求、数据库查询和分布式跟踪。
设置
选项1：远程MCP服务器（推荐）
直接连接到托管的Tusk Drift MCP服务器。这是最简单的设置，不需要在本地运行任何东西。
对于光标：
添加到光标MCP设置(~/.cursor/mcp.json 或工作空间 .cursor/mcp.json):
{
"mcpServers": {
"tusk-drift": {
"url": "https://api.usetusk.ai/api/drift-mcp",
"headers": {
"x-api-key": "YOUR_TUSK_API_KEY"
}
}
}
}
克劳德代码：
选项A--CLI命令：
claude mcp add --transport http tusk-drift https://api.usetusk.ai/api/drift-mcp \
--header "x-api-key: YOUR_TUSK_API_KEY"
选项B——添加到 .mcp.json 在项目根目录中：
{
"mcpServers": {
"tusk-drift": {
"type": "http",
"url": "https://api.usetusk.ai/api/drift-mcp",
"headers": {
"x-api-key": "YOUR_TUSK_API_KEY"
}
}
}
}
对于Claude Desktop：
{
"mcpServers": {
"tusk-drift": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.usetusk.ai/api/drift-mcp"],
"env": {
"MCP_HEADERS": "{\"x-api-key\": \"YOUR_TUSK_API_KEY\"}"
}
}
}
}
选项2：本地安装（通过NPX）
在本地运行MCP服务器。如果您需要脱机访问或自定义配置，这很有用。
对于克劳德桌面/光标：
添加到您的 claude_desktop_config.json 或光标MCP设置：
{
"mcpServers": {
"tusk-drift": {
"command": "npx",
"args": ["-y", "@use-tusk/drift-mcp"],
"env": {
"TUSK_API_KEY": "YOUR_TUSK_API_KEY"
}
}
}
}
配置（本地安装的环境变量）
| 变量 | 必填 | 描述 |
|---|---|---|
TUSK_API_KEY |
是 | 您的API代币 |
TUSK_DRIFT_API_URL |
否 | 后端基本URL（默认为 https://api.usetusk.ai).使用以下来源 https://api.usetusk.ai 或 http://localhost:8000，不 /api/drift-mcp. |
TUSK_DRIFT_SERVICE_ID |
否 | 服务ID（从中自动发现 .tusk/config.yaml 如果未设置） |
TUSK_WORKSPACE_ROOTS |
否 | 要搜索的逗号分隔的工作区根 .tusk/config.yaml 自动发现服务时的文件 |
可用工具
| 工具 | 说明 |
|---|---|
query_spans |
使用灵活的过滤器搜索API流量 |
get_schema |
获取捕获流量的结构/模式 |
list_distinct_values |
发现可用端点和字段值 |
aggregate_spans |
计算延迟百分位数、错误率、计数 |
get_trace |
将分布式跟踪视为层次树 |
get_spans_by_ids |
获取具有完整有效载荷的特定跨度 |
支持
需要帮助？打开问题或联系我们 support@usetusk.ai.
