ming-metaphysics-mcp

Claude Desktop 및 모든 MCP 호환 클라이언트를 위한 5가지 중국 형이상학 엔진 MCP 도구입니다.

Cantian의 bazi-mcp와 비교

도구

엔진 요구 사항

이 패키지는 MCP **래퍼(wrapper)**입니다. 자체적인 형이상학 계산 로직을 포함하고 있지 않으며, HTTP를 통해 Ming 엔진 엔드포인트로 도구 호출을 전달합니다. 사용하려면 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 지원을 구현하려면 api/main.py의 /consult에 해당 매개변수를 추가하고 여기의 해당 도구 핸들러를 업데이트하십시오.

개발

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초를 초과하면 엔진 병목 현상을 확인하고 MCP 설정에 timeout: 10000 추가를 고려하십시오.

인증

래퍼 수준에서는 인증이 없습니다. 이 서버는 오픈 소스이며 무료(MIT 라이선스)입니다. 인증이 필요한 경우 MING_API_URL이 가리키는 엔드포인트에서 강제합니다.

5개 엔진 통합 상담

(사주 + 자미두수 + 기문둔갑 + 풍수 + 주역을 첸 마스터가 종합한) 5개 엔진 가이드 상담은 Ming의 텔레그램 봇을 통해 이용 가능합니다. 봇이 공개 베타 상태가 되면 링크가 게시될 예정입니다.

개인정보 보호

이 MCP 래퍼 자체는 데이터를 수집하지 않습니다. 사용자가 구성한 MING_API_URL로 도구 인수(생년월일, 시간, 성별, 질문 내용)를 전달합니다. 호스팅된 엔드포인트를 가리키는 경우 해당 엔드포인트가 데이터를 수신하므로 해당 개인정보 처리방침을 읽어보십시오. 자체 호스팅하는 경우 데이터는 네트워크 외부로 나가지 않습니다.

생년월일 데이터는 민감합니다. 최종 사용자를 위해 이를 구성하는 경우 어떤 엔드포인트가 입력을 수신하는지 명확히 하십시오.

프로젝트 상태

이 패키지는 버전 1.0.0입니다. MCP 프로토콜 표면(6개 도구, JSON 스키마, 응답 형태)은 안정적입니다. 기반이 되는 Ming 엔진은 더 빠르게 발전하므로 도구 응답의 사소한 숫자 변화는 정상입니다.

기여를 환영합니다 — CONTRIBUTING.md를 참조하십시오.

라이선스

MIT — LICENSE를 참조하십시오.