@mingai/mcp

MingAI 的本地 stdio MCP Server，适合直接接入 Claude Desktop、Cursor、Cherry Studio 等支持 MCP 的客户端。

快速开始

在 MCP 客户端配置中加入：

{
  "mcpServers": {
    "mingai": {
      "command": "npx",
      "args": ["-y", "@mingai/mcp"]
    }
  }
}

要求：

• 本机已安装 Node.js
• 客户端支持 MCP stdio 连接方式

如需从 GitHub Packages 安装镜像包，请改用 @hhszzzz/mingai-mcp，并把 @hhszzzz scope 指向 https://npm.pkg.github.com。npmjs 主包名仍然是 @mingai/mcp。

可用工具

| 工具 | 说明 | |------|------| | bazi | 八字排盘 | | bazi_pillars_resolve | 四柱反推 | | bazi_dayun | 大运、小运、流年链路 | | ziwei | 紫微斗数排盘 | | ziwei_horoscope | 紫微运限 | | ziwei_flying_star | 紫微飞星 | | liuyao | 六爻排卦分析 | | meihua | 梅花易数起卦与断卦 | | tarot | 塔罗抽牌 | | almanac | 黄历查询 | | astrology | 西方占星命盘与流运 | | qimen | 奇门遁甲排盘 | | taiyi | 太乙九星观测 | | daliuren | 大六壬排盘 | | xiaoliuren | 小六壬占测 |

返回结构

本地 @mingai/mcp 的工具结果统一分成两条通道：

• content[0].text
  • 始终返回 canonical text，适合人类直接阅读或交给 AI 继续消费
• structuredContent
  • 当工具声明了 outputSchema 时返回 canonical JSON，字段结构与 outputSchema 对齐，适合程序消费

如果你要稳定的结构化结果，请始终读取 structuredContent。

其他安装方式

npm install -g @mingai/mcp

全局安装后也可以在 MCP 客户端中改成：

{
  "mcpServers": {
    "mingai": {
      "command": "mingai-mcp"
    }
  }
}

本地开发

pnpm install
pnpm -C packages/core build
pnpm -C packages/mcp build
node packages/mcp/dist/index.js

相关包

• @mingai/core: 共享算法、工具定义与 transport 适配器

版本批次

| 版本 | 批次说明 | |------|----------| | 3.4.0 | 新增 astrology 西方占星命盘与流运 | | 3.3.0 | 新增 taiyi 太乙九星观测 | | 3.2.0 | 新增 xiaoliuren 小六壬占测 | | 3.1.0 | 新增 meihua 梅花易数起卦与断卦 | | 3.0.0 | 重构包结构，优化输出与函数暴露接口 | | 2.0.0 | 规范输出结构：content 输出规范文本，structuredContent 输出 JSON | | 1.5.0 | 同步导出、共享、结构化输出策略与在线服务对齐 | | 1.4.0 | 新增 daliuren 大六壬 | | 1.3.0 | 新增 qimen 奇门遁甲 | | 1.2.6 | 补丁，集中修复输出契约、鉴权与运行时边界 | | 1.2.5 | 旧基线版本，作为本次版本重排的对比起点 |