年龄mcp
MCP服务器 阿帕奇时代 图形数据库。让AI助手（Claude、ChatGPT、Copilot等）通过 模型上下文协议.
内置F#。NET 10——1300行，21个工具，零Python依赖。
快速开始
# 1. Start the database
docker compose up -d
# 2. Install the tool
dotnet tool install --global AgeMcp
# 3. Run
AGE_CONNECTION_STRING="Host=localhost;Port=5435;Database=agemcp;Username=agemcp;Password=agemcp" age-mcp
克劳德桌面/克劳德代码
{
"mcpServers": {
"age-mcp": {
"type": "stdio",
"command": "age-mcp",
"env": {
"AGE_CONNECTION_STRING": "Host=localhost;Port=5435;Database=agemcp;Username=agemcp;Password=agemcp",
"TENANT_ID": "default"
}
}
}
}
工具（21）
图管理
| 工具 | 说明 |
|---|
get_or_create_graph | 按名称获取或创建图形 |
list_graphs | 列出所有图表（租户范围） |
drop_graphs | 删除一个或多个图形 |
顶点和边缘
| 工具 | 说明 |
|---|
upsert_vertex | 插入或更新顶点（在识别时合并） |
upsert_edge | 插入或更新定向边 |
upsert_graph | 批量追加顶点+边（事务性） |
drop_vertex | 删除顶点及其所有边 |
drop_edge | 通过标识删除边缘 |
查询
| 工具 | 说明 |
|---|
cypher_query | 执行读取Cypher查询 |
cypher_write | 执行写Cypher查询，返回受影响的计数 |
search_vertices | 按标签和/或属性搜索 |
search_edges | 按标签搜索边 |
get_neighbors | N跳遍历（1-5跳，定向） |
get_schema | 所有节点标签和计数 |
出口/进口
| 工具 | 说明 |
|---|
export_graph | 将图形导出为JSON |
import_graph | 从JSON导入（如果需要，创建图形） |
可视化和搜索
| 工具 | 说明 |
|---|
generate_visualization | 交互式vis.js HTML图形 |
semantic_search | 向量相似性搜索（pgvector） |
graph_context | 图RAG：语义种子+N跳扩展 |
OpenBrain桥
| 工具 | 说明 |
|---|
sync_to_openbrain | 将顶点导出为OpenBrain内存 |
import_from_openbrain | 从OpenBrain记忆构建图表 |
配置
| 变量 | 必填 | 默认 | 描述 |
|---|
AGE_CONNECTION_STRING | yes | 本地主机测试数据库 | Npgsql连接字符串 |
TENANT_ID | 没有 | default | 图名称的租户前缀 |
EMBEDDING_API_URL | 否 | -- | OpenAI兼容嵌入API |
EMBEDDING_API_KEY | 没有 | -- | 用于嵌入的API密钥 |
EMBEDDING_MODEL | 没有 | text-embedding-3-small | 嵌入模型名称 |
EMBEDDING_DIMENSIONS | 没有 | 384 | 矢量维度 |
码头工人
附带的Docker设置运行PostgreSQL 17+Apache AGE 1.6.0+pgvector：
docker compose up -d
版本和凭据可通过以下方式配置 .env （参见 .env.example):
PG_MAJOR=17 AGE_VERSION=1.6.0 DB_PORT=5435 docker compose up -d
数据兼容性
设计为可直接替代 agemcp python相同的租户前缀(t_{TENANT_ID}__)，相同顶点 ident 属性，相同边缘 start_ident/end_ident 物业。现有数据无需迁移即可工作。
演出
苹果M1 Pro上的BenchmarkDotNet。NET 10.0.5:
| 操作 | 延迟 | 已分配 |
|---|
| 列表图 | 62 ns | 216 B |
| get_schema | 117 ns | 344 B |
| 密码查询（1个顶点） | 1.0毫秒 | 58 KB |
| search_vertices | 1.0毫秒 | 36 KB |
| get_neighbors（深度=1） | 92毫秒 | 233 KB |
| 导出图形（40个实体） | 71毫秒 | 472 KB |
从源头构建
git clone https://github.com/Neftedollar/age-mcp.git
cd age-mcp
dotnet build
# Run directly
dotnet run
# Or install as tool
dotnet pack -c Release
dotnet tool install --global AgeMcp
许可证
麻省理工学院
