⚡ Datomic MCP Server

AI. 查询. 持久化. 扩展.
一个基于Clojure的MCP服务器，专为查询Datomic数据库并集成到AI驱动的工作流程而设计。

---

🔍 主要功能

🗄️ 连接到Datomic（SQL / 开发 / 云）

• 可以无缝连接到您的Datomic数据库，并从AI工作流程中直接运行查询。
• 支持Datomic Pro（SQL、本地开发）和Datomic Cloud环境。

📂 查询实体关系

📊 聚合查询及计算

🧾 实体属性和历史

• 探索实体属性
• 查询时间历史（截至、自某时起）
• 事务时间导航

---

⚙️ 快速开始

▶️ 运行MCP服务器

使用Clojure CLI运行：

clojure -X:mcp

或从Emacs REPL运行：

(mcp-server)

---

✅ 检查服务器状态

使用以下命令验证MCP服务器是否正常运行并响应JSON-RPC请求：

echo '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "test", "version": "1.0"}}}' \
| /usr/local/bin/clojure -M -m datomic-mcp.core

预期响应：

Datomic MCP Server 正在STDIO传输上运行。
{"jsonrpc":"2.0","method":"notifications/tools/list_changed"}
...
{"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2024-11-05","capabilities":{"logging":{},"tools":{"listChanged":true}},"serverInfo":{"name":"datomic-server","version":"0.1.0"}}}

---

🖥️ MCP客户端配置（Claude桌面）

从Claude桌面启动服务器的示例客户端设置：

{
    "datomic-mcp": {
      "command": "/bin/bash",
        "args": [
          "-c",
          "cd /Users/xlisp/CljPro/datomic-mcp-server && /usr/local/bin/clojure -M -m datomic-mcp.core"
        ]
    }

...

}

• 工具

---

🔮 发展路线图

受 https://github.com/xlisp/datascript-mcp-server 启发

1. 查询实时Datomic数据库 👉 连接到SQL / 本地开发 / 云
2. 跨Datomic + DataScript的混合查询 👉 离线 + 持久数据 https://github.com/xlisp/datascript-mcp-server
3. 可视化Datomic关系 👉 可视化MCP服务器
4. 导入/导出数据集 👉 transit, edn, 或AI生成的插入
5. 文件系统MCP集成 👉 浏览模式及迁移 https://github.com/xlisp/filesystem-mcp-server
6. 支持Datomic历史查询 👉 时间导航（截至、自某时起、历史）

---

贡献指南

1. 分叉仓库
2. 创建特性分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m '添加精彩特性')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开Pull Request

---

许可证

本项目采用MIT许可证 - 详情见LICENSE文件。

---

常见问题解答

更改列表

• 内存中的Datomic数据库已支持
• 连接任何Datomic数据库URL

在JDK 17中运行

export JAVA_HOME="/Library/Java/JavaVirtualMachines/microsoft-17.jdk/Contents/Home" #'/Library/Java/JavaVirtualMachines/microsoft-11.jdk/Contents/Home'
export PATH=$JAVA_HOME/bin:$PATH
export CPPFLAGS="-I/Library/Java/JavaVirtualMachines/microsoft-17.jdk/Contents/Home/include"

运行Datomic事务器

• datomic-pro-1.0.6165事务器必须在Java 1.8上运行

➜  datomic-pro-1.0.6165 java -version
openjdk version "17.0.16" 2025-07-15 LTS
OpenJDK 运行时环境 Microsoft-11926165 (构建 17.0.16+8-LTS)
OpenJDK 64位服务器VM Microsoft-11926165 (构建 17.0.16+8-LTS，混合模式，共享)
➜  datomic-pro-1.0.6165

➜  datomic-pro-1.0.6165 ./rundatomic.sh
正在使用Java选项 -server -Xms4g -Xmx4g -XX:+UseG1GC -XX:MaxGCPauseMillis=50 启动
正在启动 datomic:sql://<DB-NAME>?jdbc:postgresql://localhost:5432/db123123?user=postgres&password=123456，您可能需要更改用户和密码参数以与您的JDBC驱动程序配合使用...

---

由Clojure构建。由Datomic驱动。灵感来自持久查询的未来。 我们信任源代码。