Skip to content

xlisp/datascript-mcp-server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

28 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿš€ Datascript MCP Server

AI. Query. Visualize. Extend. A powerful Clojure-based MCP server built for querying DataScript and integrating with AI workflows.


๐Ÿ” Key Features

๐Ÿ•ธ๏ธ Graph path search and visualization

๐Ÿ“‚ Query parent-child relationships

๐Ÿ“Š Load examples and compute totals

๐Ÿงพ Query entity properties


โš™๏ธ Getting Started

โ–ถ๏ธ Run the MCP Server

Run with Clojure CLI:

clojure -X:mcp

Or from Emacs REPL:

(mcp-server)

โœ… Check Server Health

Use the following command to verify that the server is up and responding to 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 datascript-mcp.core

Expected response:

Datascript MCP Server running on STDIO transport.
{"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":"datascript-server","version":"0.1.0"}}}

๐Ÿ–ฅ๏ธ MCP Client Configuration (Claude Desktop)

Example client setup for launching the server from Claude Desktop:

{
  "datascript-mcp": {
    "command": "/bin/bash",
    "args": [
      "-c",
      "cd /Users/clojure/Desktop/datascript-mcp-server && /usr/local/bin/clojure -M -m datascript-mcp.core"
    ]
  }
}
  • Tools

๐Ÿ”ฎ Roadmap

  1. Import and query any DataScript dataset ๐Ÿ‘‰ load-db, It's use datascript transit
  2. Generate and insert AI-created data on the fly ๐Ÿ‘‰ add_data
  3. Connect to Datomic for hybrid querying
  4. Visualize relationship graphs and entity networks ๐Ÿ‘‰ Visualization MCP Server
  5. Support filesystem help ๐Ÿ‘‰ filesystem-mcp-server, clojure -X :mcp-filesystem
  6. Support Datahike's MCP

Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.


Built with Clojure. Powered by DataScript. Inspired by the future of intelligent querying. In the Source we trust.

About

๐Ÿš€ Datascript MCP Server

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published