Magestack (Smartxcode)

MageStack overview

MCP MageOS文档服务器

本地MCP服务器接收MageOS、Hyvä和Satoshi文档，在SQLite/FTS5中对其进行索引，并为Claude Desktop、VS Code和任何其他支持MCP的主机提供60个专用工具。

需求

• Node.js 20+
• npm 9+
• 爬行过程中的互联网访问
• 可选： GITHUB_TOKEN 在读取GitHub树时避免速率限制

安装

npm install
npm run build

更新文档数据库

# all sources
npm run update
# Hyvä only
npm run update -- --sources=hyva

SQLite数据库位于 data/docs.db.用以下命令覆盖路径和爬网程序设置 MCP_DOCS_DB_PATH, MCP_DOCS_DATA_DIR，以及中定义的其他变量 src/config.ts.

运行MCP服务器

npm start                # run the compiled CLI
npm run dev              # start via tsx for local development
node dist/cli.js --cron  # enable scheduled refresh

旗帜：

• --update –爬行并退出。
• --sources=mageos,hyva –将刷新限制为选定的源。
• --update-on-start –在服务器开始处理请求之前强制重建。
• --cron –启用调度程序模式（默认cron： 0 2 * * *).

MCP工具

• 核心公用设施： search_docs, get_doc, docs_status, refresh_docs.
• 60个特定主题的命令(hyva_*, mageos_*, satoshi_*)与以下场景保持一致 MCP-Magestack.txt.
• 更新触发器作为MCP命令公开： mcp_update_all, mcp_update_hyva, mcp_update_satoshi, mcp_update_mageos.

项目结构

src/
├── cli.ts               # CLI entry point
├── server.ts            # STDIO-based MCP server
├── config.ts            # runtime configuration
├── db/                  # SQLite schema and repository
├── crawlers/            # generic BFS scraper shared by Hyvä/MageOS/Satoshi
├── indexers/            # MageOS/Hyvä/Satoshi crawlers (web + GitHub where available)
├── mcp/                 # tool/topic registration
├── utils/               # http, parsing, hashing, logging
└── update.ts            # standalone update script

测试和植绒

npm run test
npm run lint

出版

npm publish --access public

发布后，按如下方式配置MCP主机（例如Claude Desktop）：

{
  "mcpServers": {
    "mageosDocs": {
      "command": "npx",
      "args": ["@smartx/mcp-mageos-docs@latest"]
    }
  }
}

################################################################################

本地MCP服务器下载MageOS，Hyvä和Satoshi文档，将其索引到SQLite / FTS5，并暴露60个工具，供MCP主机即时使用（Claude Desktop，VS Code等）。

要求

• Node.js 20+
• npm 9+
• 在索引时访问互联网
• （可选） GITHUB_TOKEN 在下载仓库时获得更快的限制速率

安装

npm install
npm run build

更新文档库

# wszystkie źródła
npm run update
# tylko Hyvä
npm run update -- --sources=hyva

SQLite数据库位于 data/docs.db环境变量可以控制 MCP_DOCS_DB_PATH, MCP_DOCS_DATA_DIR 和其他 src/config.ts.

启动 MCP

npm start                # uruchom build i serwer MCP
npm run dev              # CLI w trybie ts-node/tsx
node dist/cli.js --cron  # uruchom cronowe odświeżanie

论据：

• --update 只需索引并完成。
• --sources=mageos,hyva 将更新限制在选定的来源。
• --update-on-start 在MCP服务器启动时强制重建索引。
• --cron 启用更新计划（默认情况下） 0 2 * * *).

MCP工具

• search_docs, get_doc, docs_status, refresh_docs
• 60个专题工具（hyva_*, mageos_*, satoshi_*（3）相应的文档部分。
• MCP 更新命令： mcp_update_all, mcp_update_hyva, mcp_update_satoshi, mcp_update_mageos.

项目结构

src/
├── cli.ts               # punkt wejścia (bin)
├── server.ts            # uruchamia MCP w STDIO
├── config.ts            # konfiguracja źródeł
├── db/                  # schema i repozytorium SQLite
├── crawlers/            # współdzielony BFS crawler
├── indexers/            # crawlerzy MageOS/Hyvä/Satoshi (strony + GitHub tam gdzie trzeba)
├── mcp/                 # rejestracja narzędzi, tematy
├── utils/               # http, parsery, hash, logger
└── update.ts            # skrypt aktualizacji

皮棉

npm run test
npm run lint

出版物

npm publish --access public

发布后，MCP 主机（例如 Claude Desktop）可以使用服务器：

{
  "mcpServers": {
    "mageosDocs": {
      "command": "npx",
      "args": ["@smartx/mcp-mageos-docs@latest"]
    }
  }
}