Skip to content

xlisp/datascript-mcp-server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

20 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿš€ Datascript MCP Server

Query. Visualize. Extend. AI. 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
  2. Generate and insert AI-created data on the fly
  3. Connect to Datomic for hybrid querying
  4. Visualize relationship graphs and entity networks ๐Ÿ‘‰ Visualization MCP Server
  5. 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