ming-metaphysics-mcp

Пять движков китайской метафизики в качестве инструментов MCP для Claude Desktop и любого клиента, совместимого с MCP.

vs bazi-mcp от Cantian

Инструменты

Требования к движку

Этот пакет является оберткой MCP. Он не содержит логики вычислений метафизики — он перенаправляет вызовы инструментов на конечную точку движка Ming по HTTP. Чтобы использовать его, укажите MING_API_URL на запущенный движок.

Два способа получить движок:

1. Хостинговая конечная точка (предпочтительно, когда доступна). Публичная конечная точка Ming будет анонсирована; как только она станет доступна, настройте MING_API_URL, чтобы указывать на нее, и все готово.

2. Самостоятельный хостинг. Сам движок Ming в настоящее время является эталонной реализацией с закрытым исходным кодом. Если у вас есть доступ к кодовой базе Ming, запустите uvicorn api.main:app --port 8000 и укажите этот MCP на localhost:8000.

Без доступного движка сервер MCP запускается и перечисляет инструменты, но вызовы инструментов возвращают ошибку HTTP.

Установка

Шаг 1 — Убедитесь, что движок доступен

См. «Требования к движку» выше.

Шаг 2 — Установите сервер MCP

npm install -g ming-metaphysics-mcp

Шаг 3 — Добавьте в claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ming": {
      "command": "ming-metaphysics-mcp",
      "args": [],
      "env": {
        "MING_API_URL": "http://localhost:8000"
      }
    }
  }
}

Перезапустите Claude Desktop. Инструменты Ming появятся в списке инструментов.

Проверка

В Claude Desktop:

Using the ming_bazi_analyze tool, analyze the chart for someone born 1990-03-15, male, in Singapore.

Вы должны получить полное чтение Ба-цзы. Если инструмент выдает ошибку, проверьте, запущен ли движок Python на порту 8000.

Пробелы в конечных точках

Следующие возможности требуют расширения FastAPI, прежде чем они будут полностью функционировать, как указано. Каждая из них помечена примечанием в ответе инструмента — никаких скрытых сбоев.

Чтобы реализовать поддержку летящих звезд для конкретного года или forecast_year, добавьте эти параметры в /consult в api/main.py и обновите соответствующие обработчики инструментов здесь.

Разработка

git clone <this-repo>
cd ming-metaphysics-mcp
npm install
npm run build          # compile TypeScript → dist/
npm test               # smoke tests (no engine required)

# With engine running at localhost:8000:
npx ts-node scripts/benchmark.ts --tool all --iterations 5

Переменные окружения

Целевые показатели задержки

Если какой-либо инструмент постоянно превышает 5 секунд, проверьте узкое место движка и рассмотрите возможность добавления timeout: 10000 в конфигурацию MCP.

Аутентификация

На уровне обертки отсутствует — этот сервер является открытым и бесплатным (лицензия MIT). Аутентификация, если она есть, обеспечивается любой конечной точкой, на которую указывает MING_API_URL.

Для полного чтения по пяти движкам

Управляемая консультация по пяти движкам (Ба-цзы + Цзы Вэй + Ци Мэнь + Фэн-шуй + И Цзин, синтезированные мастером Ченом) доступна через Telegram-бота Ming. Ссылка будет опубликована, как только бот перейдет в стадию публичного бета-тестирования.

Конфиденциальность

Сама эта обертка MCP не собирает данные. Она пересылает аргументы вашего инструмента (дата рождения, час, пол, текст вопроса) на любой MING_API_URL, который вы настроили. Если вы указываете на хостинговую конечную точку, эта конечная точка получает данные — ознакомьтесь с ее политикой конфиденциальности. Если вы используете собственный хостинг, данные не покидают вашу сеть.

Данные о рождении являются конфиденциальными. Если вы настраиваете это для конечных пользователей, четко укажите, какая конечная точка получает их данные.

Статус проекта

Этот пакет имеет версию 1.0.0. Поверхность протокола MCP (6 инструментов, схемы JSON, формы ответов) стабильна. Базовый движок Ming развивается быстрее — незначительные числовые изменения в ответах инструментов являются нормальными.

Вклад приветствуется — см. CONTRIBUTING.md.

Лицензия

MIT — см. LICENSE.