Mystilink MCP

Una calculadora metafísica de múltiples teorías para uso de agentes, que incluye Bazi, Ziwei Dou Shu, Liuyao, Tarot y Horóscopo, proporcionando cartas precisas para lectura, manifestación y predicción.

GitHub

Documentación

Mystilink MCP

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

Resumen

Integración local que expone las CLIs de la calculadora Mystilink como herramientas MCP (stdio) para hosts de agentes como Cursor. Opcionalmente sirve la misma orquestación sobre FastAPI en loopback en 127.0.0.1 para depuración local.

Este paquete no calcula cartas. Ejecuta CLIs cortas instaladas (bazi, ziwei, horoscope, lunar, tarot, liuyao) y devuelve JSON. Las respuestas predeterminadas de las herramientas usan mystilink.envelope/0.1 cuando la calculadora admite --envelope.

No hay ningún servicio HTTP/HTTPS remoto que desplegar. La entrada de FastAPI es solo para localhost.

Endpoints

Agente: https://www.mystilink.com
Wiki de teoría: https://wiki.mystilink.com (API /api/v1)

Tipo de entrega

Este repositorio es un paquete de integración MCP / local. No implementa la matriz de lenguajes C / C++ / C# / Java / JavaScript / Python utilizada por las bibliotecas de calculadoras.

Requisitos

Python 3.10+
CLIs de calculadora en PATH (instala los paquetes correspondientes), o establece las variables de entorno MYSTILINK_*_CLI

Sistema	CLI corta	Anulación de entorno
lunar	`lunar`	`MYSTILINK_LUNAR_CLI`
bazi	`bazi`	`MYSTILINK_BAZI_CLI`
ziwei	`ziwei`	`MYSTILINK_ZIWEI_CLI`
horoscope	`horoscope`	`MYSTILINK_HOROSCOPE_CLI`
tarot	`tarot`	`MYSTILINK_TAROT_CLI`
liuyao	`liuyao`	`MYSTILINK_LIUYAO_CLI`

Instalación

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

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

Sondear CLIs:

mystilink-mcp status
mystilink-mcp version

MCP (stdio)

La entrada predeterminada inicia el servidor MCP en stdio:

mystilink-mcp
# same as:
mystilink-mcp stdio

Ejemplo de configuración de MCP en Cursor

Consulta examples/cursor-mcp.json. Forma típica:

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

Asegúrate de que las CLIs de la calculadora estén en el mismo PATH que el proceso que lanza Cursor.

Herramientas

Herramienta	Calculadora
`lunar_convert`	`lunar convert`
`bazi_calculate`	`bazi calculate`
`bazi_dayun`	`bazi dayun`
`bazi_liunian`	`bazi liunian`
`ziwei_chart`	`ziwei chart`
`horoscope_natal`	`horoscope natal`
`tarot_draw`	`tarot draw`
`liuyao_cast`	`liuyao cast`
`list_cli_status`	Sonda PATH
`version`	versión del paquete

La mayoría de las herramientas de cartas aceptan envelope (predeterminado true) y locale opcional.

FastAPI local (solo 127.0.0.1)

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

Método	Ruta
GET	`/health`
GET	`/v1/cli-status`
POST	`/v1/lunar/convert`
POST	`/v1/bazi/calculate`
POST	`/v1/bazi/dayun`
POST	`/v1/bazi/liunian`
POST	`/v1/ziwei/chart`
POST	`/v1/horoscope/natal`
POST	`/v1/tarot/draw`
POST	`/v1/liuyao/cast`

Ejemplo:

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}'

API de Python

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)

Limitaciones

Requiere paquetes / CLIs de calculadora instalados por separado
No interpreta cartas ni llama a APIs remotas de productos Mystilink
El host de FastAPI local está fijado a 127.0.0.1

Licencia

MIT. Consulta LICENSE.

Comentarios

Reporta problemas con: nombre de la herramienta, versión de la CLI (bazi version, …) y una carga útil ficticia mínima.