使用说明
突触mcp
MCP服务器 突触开源智能超图平台。为AI代理提供对Synapse Cortex的结构化访问，用于威胁情报分析、指标旋转和数据探索。
模式
服务器支持两种工具模式，由 MCP_MODE 环境变量：
| 模式 | MCP_MODE |
说明 |
|---|---|---|
| API | api （默认） |
风暴驱动的工具包。代理直接编写Storm查询。包括Storm快速参考资源。 |
| 摘要 | abstract |
内部生成Storm的结构化参数工具。代理在不知道Storm语法的情况下描述它想要什么（表单、标签、过滤器）。 |
两种模式共享 get_cortex_info, search_views，以及 get_model 工具。
API模式工具
| 工具 | 说明 |
|---|---|
storm_query |
执行Storm查询，返回解析的节点或打印输出 |
storm_call |
执行Storm查询，通过以下方式返回单个值 return() |
get_model |
查找数据模型表单及其属性 |
count_by_form |
按表单类型分组的节点计数 |
抽象模式工具
| 工具 | 说明 |
|---|---|
lookup |
按形式和值查找节点 |
search_by_tag |
使用计数/分组选项按标签查找节点 |
search_by_value |
在节点值上进行子字符串搜索 |
pivot |
通过连接的节点进行查询、过滤和可选的枢轴。无跳跃：提升+过滤。有跳数：单跳或多跳枢轴，带每跳过滤器。 |
explore_edges |
仅计数显示连接到节点的内容的枢轴 |
traverse_edge |
遍历灯光边缘（参考、使用、可见等） |
get_model |
查找数据模型表单及其属性 |
设置
先决条件
- Python 3.10+
- 运行中的Synapse Cortex（参见 Synapse部署文档)
安装
git clone <repo-url> && cd synapse-mcp
uv venv && uv pip install -e .
本地Synapse堆栈（可选）
A. docker-compose.yml 用于运行完整的本地堆栈（AHA、Axon、JSONStor、Cortex）：
# First time: provisions services and creates root user
./scripts/bootstrap.sh
# With data import (place .nodes files in data/)
./scripts/bootstrap.sh --load-data
# Subsequent runs
docker compose up -d
配置
环境变量
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
SYNAPSE_URL |
是 | Cortex HTTPS URL（例如。 https://localhost:4443) |
|
SYNAPSE_USER |
基本身份验证的用户名 | ||
SYNAPSE_PASS |
基本身份验证密码 | ||
SYNAPSE_API_KEY |
API密钥身份验证（优先于用户/通行证） | ||
SYNAPSE_VERIFY_SSL |
true |
设置 false 用于自签名证书 |
|
SYNAPSE_VIEW |
默认视图ID（32个字符，十六进制）。如果未设置，则使用Cortex默认视图。 | ||
MCP_MODE |
api |
刀具模式： api 或 abstract |
|
MCP_TRANSPORT |
stdio |
运输： stdio 或 sse |
MCP客户端配置
复制示例并填写您的值：
cp .mcp.json.example .mcp.json
示例 .mcp.json:
{
"mcpServers": {
"synapse": {
"command": "synapse-mcp",
"env": {
"SYNAPSE_URL": "https://localhost:4443",
"SYNAPSE_USER": "root",
"SYNAPSE_PASS": "secret",
"SYNAPSE_VERIFY_SSL": "false",
"MCP_MODE": "abstract",
"MCP_TRANSPORT": "stdio"
}
}
}
}
视图
所有查询工具都接受可选 view 参数（32个字符的十六进制标识），以针对非默认视图。您还可以设置 SYNAPSE_VIEW 更改所有查询的默认值。
使用 search_views 按名称查找视图：
search_views(query="threat-intel")
优先级：按查询 view 参数> SYNAPSE_VIEW env-var>Cortex默认视图。
