Mystilink MCP

Uma calculadora metafísica multi-teorias para uso por agentes, abrangendo Bazi, Ziwei Dou Shu, Liuyao, Tarot e Horóscopo, fornecendo mapas precisos para leitura, manifestação e previsão.

GitHub

Documentação

Mystilink MCP

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

Visão geral

Integração local que expõe os CLIs da calculadora Mystilink como ferramentas MCP (stdio) para hosts de Agentes, como o Cursor. Opcionalmente, serve a mesma orquestração via FastAPI em loopback em 127.0.0.1 para depuração local.

Este pacote não calcula mapas. Ele executa CLIs curtos instalados (bazi, ziwei, horoscope, lunar, tarot, liuyao) e retorna JSON. As respostas padrão das ferramentas usam mystilink.envelope/0.1 quando a calculadora suporta --envelope.

Não há serviço HTTP/HTTPS remoto para implantar. A entrada FastAPI é exclusiva para localhost.

Endpoints

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

Tipo de entrega

Este repositório é um pacote de integração MCP / local. Ele não implementa a matriz de linguagens C / C++ / C# / Java / JavaScript / Python usada pelas bibliotecas de calculadora.

Requisitos

Python 3.10+
CLIs de calculadora no PATH (instale os pacotes correspondentes) ou defina as variáveis de ambiente MYSTILINK_*_CLI

Sistema	CLI curto	Substituição de env
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`

Instalação

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

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

Teste os CLIs:

mystilink-mcp status
mystilink-mcp version

MCP (stdio)

A entrada padrão inicia o servidor MCP em stdio:

mystilink-mcp
# same as:
mystilink-mcp stdio

Exemplo de configuração MCP no Cursor

Consulte examples/cursor-mcp.json. Formato típico:

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

Garanta que os CLIs da calculadora estejam no mesmo PATH que o processo iniciado pelo Cursor.

Ferramentas

Ferramenta	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`	versão do pacote

A maioria das ferramentas de mapa aceita envelope (padrão true) e locale opcional.

FastAPI local (somente 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	Caminho
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`

Exemplo:

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 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)

Limitações

Requer pacotes / CLIs de calculadora instalados separadamente
Não interpreta mapas nem chama APIs remotas de produtos Mystilink
O host FastAPI local é fixado em 127.0.0.1

Licença

MIT. Consulte LICENSE.

Feedback

Relate problemas com: nome da ferramenta, versão do CLI (bazi version, …) e um payload fictício mínimo.