2

2025 Tax Law Amendment MCP Server

Enables users to search and query information from the 2025 Korean tax law amendment PDF documents u...

33 views
0 installs
Updated Feb 8, 2026
Not audited
Tools I Recommend
Enables users to search and query information from the 2025 Korean tax law amendment PDF documents using natural language. Provides document indexing and retrieval capabilities through ChromaDB vector storage and LangChain integration.
  1. 프로젝트 루트로 이동하여 README 확인

    • 터미널에서 프로젝트 루트로 이동합니다.
    • README에 명시된 환경변수 목록을 확인합니다: CHROMA_HOST, CHROMA_PORT, PDF_PATH.
  2. Chroma(벡터 DB) 호스트와 포트 확인

    • 로컬에서 docker-compose로 실행한 경우(README 권장):
      • docker-compose.yml에서 포트 매핑을 확인합니다.
        cat docker-compose.yml | sed -n '1,200p'
        
        또는 실행 중인 컨테이너의 포트 정보를 확인합니다.
        docker-compose ps
        # 또는
        docker ps --format '{{.Names}}  {{.Ports}}'
        
      • 일반적으로 CHROMA_HOST는 "localhost" (또는 도커를 외부에서 접근할 수 있도록 설정한 호스트 IP)이고 CHROMA_PORT는 docker-compose.yml이나 docker ps 출력에 매핑된 포트(예: 8000)입니다.
    • 원격 서버에 설치된 경우:
      • Chroma가 설치된 서버의 IP 또는 도메인과 해당 서비스의 포트를 확인해서 CHROMA_HOST와 CHROMA_PORT에 사용합니다.
  3. PDF 파일 경로(PDF_PATH) 준비

    • 기본값: 프로젝트 루트의 2025_tax.pdf
    • PDF 파일이 프로젝트 루트에 없다면 복사하거나 이동합니다:
      # 예: 프로젝트 루트로 PDF 복사
      cp /path/to/your/2025_tax.pdf /path/to/project/2025_tax.pdf
      
    • 절대경로를 사용하려면 전체 경로를 메모합니다(e.g. /home/user/project/2025_tax.pdf).
  4. 값 정리(예시)

    • CHROMA_HOST: localhost (또는 192.0.2.10 등)
    • CHROMA_PORT: 8000 (docker-compose에서 확인한 포트)
    • PDF_PATH: /absolute/path/to/2025_tax.pdf 또는 프로젝트 상대경로인 2025_tax.pdf
  5. FastMCP 연결 인터페이스에서 Install Now 버튼으로 환경변수 입력

    • FastMCP 연결 인터페이스를 엽니다.
    • "Install Now" 버튼을 클릭합니다.
    • 환경변수 입력 폼에 다음 키와 값을 채웁니다(따옴표 없이 입력):
      • CHROMA_HOST = <위에서 확인한 호스트값>
      • CHROMA_PORT = <위에서 확인한 포트값>
      • PDF_PATH = <위에서 준비한 파일 경로>
    • 저장 또는 적용 버튼을 클릭하여 설정을 확정합니다.
  6. MCP 서버 재시작 및 동작 확인

    • FastMCP에서 설정 적용 후 MCP 서버를 재시작하거나, 수동 실행 환경이라면 다음 명령으로 재시작합니다:
      # 예: 터미널에서 직접 실행하는 경우
      python mcp_server.py
      
    • 서버 로그 또는 FastMCP UI에서 정상적으로 Chroma에 연결되었는지, PDF 파일을 읽어들이는지 확인합니다.
      • 로컬에서 로그 확인 예:
        # 서버 실행 로그 확인
        tail -f /path/to/project/server.log
        
      • 연결 실패 시 CHROMA_HOST/CHROMA_PORT가 올바른지, PDF_PATH가 정확한 파일을 가리키는지 재확인합니다.
  7. 문제 해결 팁

    • 포트 차단 방지: 로컬 방화벽 또는 원격 서버의 방화벽에서 CHROMA_PORT가 허용되어 있는지 확인합니다.
    • 컨테이너 내부 서비스 확인: docker exec로 컨테이너 내부에서 서비스 포트가 리스닝 중인지 확인할 수 있습니다.
      docker exec -it <container_name> ss -ltnp
      
    • PDF 경로 권한 문제: MCP 프로세스가 PDF 파일에 읽기 권한이 있는지 확인합니다.
      ls -l /path/to/2025_tax.pdf
      
  8. 완료

    • FastMCP의 Install Now 통해 입력한 값으로 MCP가 정상 동작하면 설정이 완료된 것입니다.

Quick Start

View on GitHub

More for AI and Machine Learning

View All →

More for API Development

View All →

Report Issue

Thank you! Your issue report has been submitted successfully.