Mystilink MCP

Languages: English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Français | Español

Overview

Local integration that exposes Mystilink calculator CLIs as MCP tools (stdio) for Agent hosts such as Cursor. Optionally serves the same orchestration over loopback FastAPI on 127.0.0.1 for local debugging.

This package does not compute charts. It spawns installed short CLIs (bazi, ziwei, horoscope, lunar, tarot, liuyao) and returns JSON. Default tool responses use mystilink.envelope/0.1 when the calculator supports --envelope.

There is no remote HTTP/HTTPS service to deploy. The FastAPI entry is localhost-only.

Related MCP server: 命盘 Mingpan

Endpoints

• Agent: https://www.mystilink.com

• Theory Wiki: https://wiki.mystilink.com (API /api/v1)

Delivery type

This repository is an MCP / local integration package. It does not implement the C / C++ / C# / Java / JavaScript / Python language matrix used by calculator libraries.

Requirements

• Python 3.10+

• Calculator CLIs on PATH (install the corresponding packages), or set MYSTILINK_*_CLI env vars

Install

cd mystilink-mcp
python3 -m pip install -e .

# optional local FastAPI extras
python3 -m pip install -e '.[local-api]'

Probe CLIs:

mystilink-mcp status
mystilink-mcp version

MCP (stdio)

Default entry starts the MCP server on stdio:

mystilink-mcp
# same as:
mystilink-mcp stdio

Cursor MCP config example

See examples/cursor-mcp.json. Typical shape:

{
  "mcpServers": {
    "mystilink": {
      "command": "mystilink-mcp",
      "args": ["stdio"]
    }
  }
}

Ensure calculator CLIs are on the same PATH as the process Cursor launches.

Tools

Most chart tools accept envelope (default true) and optional locale.

Local FastAPI (127.0.0.1 only)

mystilink-mcp local-api
# listens on http://127.0.0.1:8765
# override port: MYSTILINK_MCP_LOCAL_PORT=8765

Example:

curl -s http://127.0.0.1:8765/health
curl -s -X POST http://127.0.0.1:8765/v1/tarot/draw \
  -H 'content-type: application/json' \
  -d '{"seed":123}'

Python API

from mystilink_mcp.tools import bazi_calculate, tarot_draw

chart = bazi_calculate(date="1990-05-15", hour=12, timezone="Asia/Shanghai")
draw = tarot_draw(seed=123)

Limits

• Requires separately installed calculator packages / CLIs

• Does not interpret charts or call remote Mystilink product APIs

• Local FastAPI host is hardcoded to 127.0.0.1

License

MIT. See LICENSE.

Feedback

Report issues with: tool name, CLI version (bazi version, …), and a minimal fictional payload.