Skip to content

FantomMcpServer 1.0.0

Choose a tag to compare

View all tags
@alperu alperu released this 18 Sep 21:00
· 2 commits to main since this release
v1.0.0
ca39187

First public release.

An MCP server that gives AI assistants a working knowledge of a Fantom / Haxall / SkySpark codebase — semantic code search, natural-language Q&A, a real call graph, and Axon parsing — with a web dashboard for running and watching the indexing.

Highlights

  • Semantic code search over Fantom source and Axon functions, chunked at syntactic boundaries and searched by vector similarity with optional cross-encoder rerank.
  • askCodebase — natural-language questions answered with citations from a retrieval loop over the index.
  • Call graph — getCallers, getCallees, getCodeImpact, getCodeNeighbors, stored in an embedded graph database.
  • Axon via tree-sitter — statement-aligned chunks, defcomp cells surfaced as the component's interface, comments preserved as search signal. Works against synced proj/ folders and offline library exports, with no SkySpark instance required.
  • History tools — whatChangedRecently, getSymbolHistory, explainSymbolChange, diffIndexRuns.
  • Documentation indexing for fantom.org, haxall.io and local pod docs.
  • SkySpark 3.x → 4.0 migration with a backup tag, plus commit/rollback.
  • Flexible embedding routing — local GPU hosts, OpenRouter, or both in one pool, per role. Cloud providers must pass a vector-compatibility check before writing to a table, and the query encoder always comes from the pool that built the rows.

41 MCP tools in total.

Install

git clone https://github.com/Project-SandStar/FantomMcpServer.git
cd FantomMcpServer
npm install && npm run build
npm start            # stdio
npm run start:http   # HTTP + dashboard on :3847

Requires Node.js 20+ and an embedding provider. See the README.

The admin API ships with admin/admin. Change it before binding to anything but localhost.

Note on history

This is a snapshot release with no prior ancestry — development history stays in the private upstream repository. Internal engineering notes (docs/reports, docs/tasks) are not part of the public tree.

Licensed under the Project Sandstar Source-Available License (PSSL) v1.1.

Assets 3
Loading