Bibliomantic MCP Server

한 줄 요약:

AI 채팅이 주어진 작업을 완료하기 위해 I Ching에서 무작위로 선택된 중국 지혜의 조각이 필요할 때마다 호출할 수 있는 Model-Context-Protocol 서버를 제공합니다.

Related MCP server: taibu

원본 간결 요약

I Ching 점술을 AI 응답에 통합하고 Philip K. Dick의 The Man in the High Castle에 묘사된 도서 점술(bibliomantic) 접근법을 탐구하는 Model Context Protocol 서버입니다.

목적

이 서버는 전통 지혜 체계가 MCP를 통해 현대 AI와 어떻게 신중하게 통합될 수 있는지 보여줍니다. 제공하는 기능은 다음과 같습니다:

• 교육적 탐구 - 고대 중국 철학과 I Ching

• 문학적 맥락 - Philip K. Dick의 영향력 있는 SF 작품

• 철학적 성찰 도구 - 창의적 사고와 관점 전환을 위한

• 기술적 시연 - 도구, 리소스, 프롬프트를 갖춘 FastMCP 기능

특징

• 전통적인 I Ching 시스템 - 64괘 전체와 정통 세 동전 방법 시뮬레이션

• 도서 점술 상담 - "The Man in the High Castle"에 나오는 Philip K. Dick의 접근법에 따름

• FastMCP 구현 - 도구, 리소스 및 프롬프트를 갖춘 전문적인 MCP 준수

• 윤리적 안전장치 - 오락/성찰 목적에 대한 명확한 고지

• 교육적 맥락 - 각 상담에 대한 역사적, 철학적 배경

• 리소스 접근 - AI 컨텍스트 로딩을 위한 직접적인 괘 데이터베이스 접근

사전 요구 사항

• Python 3.10+ (MCP SDK에서 요구)

• MCP 호환 호스트 (Claude Desktop 등)

설치

소스에서

git clone https://github.com/d4nshields/bibliomantic-mcp-server.git
cd bibliomantic-mcp-server
pip install -e .

대체 구성:

{
  "mcpServers": {
    "bibliomantic": {
      "command": "python",
      "args": ["-m", "bibliomantic_server"]
    }
  }
}

사용 가능한 도구

• i_ching_divination - 전통적인 해석과 함께 무작위 괘를 생성합니다.

• bibliomantic_consultation - 쿼리 확장을 포함한 전체 도서 점술 과정

• get_hexagram_details - 숫자(1-64)로 특정 괘를 조회합니다.

• server_statistics - 시스템 정보 및 기능을 확인합니다.

리소스

• hexagram://{number} - AI 컨텍스트를 위한 개별 괘 데이터 로드

• iching://database - 완전한 64괘 데이터베이스 개요에 접근

프롬프트 템플릿

• career_guidance_prompt - 경력 결정을 위한 구조화된 프롬프트

• creative_guidance_prompt - 예술 및 창의적 프로젝트를 위한 프롬프트

• general_guidance_prompt - 보편적인 삶의 지침 템플릿

사용 예시

기본 점술

Claude에게 물어보세요:

"제 창의적인 프로젝트에 대한 철학적 지침을 위해 I Ching 점술을 수행할 수 있나요?"

도서 점술 상담

"경력 경로에 관한 어려운 결정에 직면해 있습니다. 도서 점술 접근법을 사용하여 I Ching을 상담해 주실 수 있나요?"

리소스 접근

"The Creative를 이해하기 위해 hexagram://1 리소스를 로드하세요."

특정 괘 조회

"I Ching 42번째 괘에 대해 알려주시겠어요?"

도서 점술 접근법

이 구현은 Philip K. Dick의 The Man in the High Castle에 묘사된 점술 방법을 따릅니다. 이 작품에서는 등장인물들이 중요한 결정에 대한 지침을 얻기 위해 I Ching을 상담합니다. 이 시스템은:

• 전통적인 I Ching 방법론과 세 동전 던지기를 사용합니다.

• 정통 점술을 위한 암호학적으로 안전한 난수를 생성합니다.

• 고대의 지혜와 현대 AI 기능을 통합합니다.

• 도서 점술의 철학적이고 성찰적인 측면을 유지합니다.

• 점술 과정의 투명성을 제공합니다.

윤리적 프레임워크

모든 응답에는 이것이 오직 철학적 성찰과 오락을 위한 것이며 초자연적 지침이나 인생 조언이 아니라는 명확한 고지가 포함됩니다. 사용자는 중요한 결정을 위해 자격을 갖춘 전문가와 상담하도록 안내받습니다.

이 서버는 다음을 강조합니다:

• 지혜 전통에 대한 교육적 탐구

• 창의적 사고와 관점 수용

• 예측보다는 철학적 성찰

• 고대 전통과 현대 윤리 기준 모두에 대한 존중

개발

MCP Inspector로 테스트

mcp dev bibliomantic_server.py

로컬에서 실행

python bibliomantic_server.py

기술 구현

다음으로 구축되었습니다:

• FastMCP - 전문적인 준수를 위한 공식 MCP Python SDK

• 전통적인 I Ching - 정통 해석을 갖춘 완전한 64괘 데이터베이스

• 암호화된 난수 - Python의 secrets 모듈을 사용한 안전한 세 동전 시뮬레이션

• 타입 안전성 - 자동 JSON 스키마 생성을 통한 전체 타입 힌트

• 윤리적 안전장치 - 모든 응답에서 사용자에게 제공되는 고지

사용 사례

• 교육 도구 - I Ching 철학과 중국 지혜 전통 학습용

• 창의적 글쓰기 보조 도구 - 새로운 관점과 영감 생성용

• 철학적 성찰 도구 - 인생의 결정과 변화에 대한 숙고용

• 문화적 다리 - 고대 지혜와 현대 AI 기능 사이의

• 기술적 시연 - 문화적 콘텐츠를 포함한 MCP 서버 개발

• 문학적 분석 - Philip K. Dick의 주제와 도서 점술 개념 분석

보안 고려 사항

• 모든 사용자 쿼리와 매개변수에 대한 입력 검증

• 외부 네트워크 요청이나 API 의존성 없음

• 암호학적으로 안전한 난수 생성

• 명확한 윤리적 경계와 사용자 교육

• 영구 데이터 저장이나 사용자 추적 없음

기여

기여를 환영합니다! 다음을 지켜주세요:

1. 기존 코드 스타일과 패턴을 따르세요

2. MCP Inspector를 사용하여 새로운 기능에 대한 테스트를 추가하세요

3. 변경 사항에 대한 문서를 업데이트하세요

4. 공식 MCP SDK와의 호환성을 보장하세요

5. 윤리적 프레임워크와 교육적 초점을 유지하세요

라이선스

MIT 라이선스 - 자세한 내용은 LICENSE 파일을 참조하세요.

감사의 말

• Philip K. Dick - 문학적 영감과 도서 점술 접근법에 대해

• 고대 중국 철학자들 - I Ching 지혜 전통에 대해

• Anthropic - Model Context Protocol과 FastMCP 프레임워크에 대해

• MCP 커뮤니티 - 혁신적인 AI 통합을 조성한 것에 대해

"신탁은 옳았다. 미래는 여전히 앞에 있다." - Philip K. Dick, The Man in the High Castle