모델 컨텍스트 프로토콜 TypeScript 구현

개요

이 프로젝트는 개인 지능 프레임워크(PIF)의 실질적인 구현체로서 모델 컨텍스트 프로토콜(MCP)을 구현합니다. 체계적인 도구와 점진적인 상호작용 패턴을 통해 인간과 AI 간의 의미 있는 이해를 위한 공간을 조성합니다.

빠른 시작

필수 조건

• Node.js 18+ 및 npm
• 타입스크립트 5.0+
• 모델 컨텍스트 프로토콜 TypeScript SDK
• 사용자 정의 서버에 맞게 구성된 Claude Desktop Client

참고 : 이 구현은 Windows와 macOS/Linux 시스템 모두에서 테스트되었습니다.

설정

1. 저장소를 복제합니다.

지엑스피1

2. 종속성 설치:

3. 서버를 구성하세요:
   • 이제 구성은 기본적으로 자동 감지되지만 다음을 사용자 정의할 수 있습니다.
     • MCP_WORKSPACE_ROOT 환경 변수를 설정하여 작업 공간 위치를 지정합니다.
     • 또는 구성 옵션의 JSON 문자열로 MCP_CONFIG 환경 변수를 설정합니다.
     • 또는 src/config.ts 직접 편집하여 기본 구성을 수정합니다.
4. 서버를 빌드하세요:

5. Claude Desktop Client 구성:
   • Claude Desktop Client 구성 디렉토리를 찾으세요
   • claude_desktop_config.json 생성하거나 수정합니다.
     { "mcpServers": { "mcp-pif": { "command": "node", "args": ["path/to/your/mcp-pif/build/index.js"], "cwd": "path/to/your/mcp-pif", "env": {} } } }
   • path/to/your/mcp-pif 실제 저장소 경로로 바꾸세요.
   • 경로는 운영 체제에 맞게 자동으로 정규화됩니다.
6. Claude 데스크톱 클라이언트 연결:
   • Claude Desktop Client를 시작하거나 다시 시작합니다.
   • 사용자 지정 서버로 "mcp-pif"를 선택하세요
   • 서버 사용을 시작하려면 새 채팅을 시작하세요.

디렉토리 구조

서버는 구성된 작업 공간에서 다음 구조를 만들고 관리합니다.

다음 단계

• 사용 가능한 도구에 대한 모듈 설명서를 검토하세요.
• 구현 세부 정보는 아키텍처 가이드를 참조하세요.
• 기여 지침은 개발 가이드를 확인하세요.

문제 해결

• 경로를 수동으로 지정하는 경우 플랫폼에 적합한 구분 기호(Windows에서는 백슬래시, macOS/Linux에서는 슬래시)를 사용하세요.
• 연결이 실패하면 Claude Desktop Client 로그를 확인하세요.
• 작업 공간 디렉토리가 존재하고 쓰기 가능한지 확인하세요.
• Node.js 및 TypeScript 버전이 요구 사항을 충족하는지 확인하세요.

핵심 구현

사용 가능한 도구

구현에서는 구조화된 상호작용을 지원하도록 설계된 핵심 도구 세트를 제공합니다.

• 파일 시스템 작업 : 작업 공간 컨텍스트 탐색 및 관리
  • pwd , cd , read , write , mkdir , delete , move , rename
• 추론 도구 : 체계적인 사고를 위한 공간 만들기
  • reason : 연결된 통찰력을 개발합니다
  • think : 묵상을 위한 시간적 공간을 만들다
• 저널 시스템 : 프레임워크 연속성 유지
  • journal_create : 문서 개발
  • journal_read : 패턴 탐색

기본 사용법

크로스 플랫폼 지원

MCP-PIF 서버는 Windows, macOS, Linux 환경에서 원활하게 작동하도록 설계되었습니다.

경로 처리

• 모든 파일 경로는 현재 운영 체제에 맞게 자동으로 정규화됩니다.
• 작업 공간 루트는 현재 환경에 따라 자동으로 감지됩니다.
• 작업 공간 내에서는 절대 경로와 상대 경로가 모두 지원됩니다.

구성

• 환경 변수는 서버를 구성하는 크로스 플랫폼 방식을 제공합니다.
• 파일 작업은 일관된 동작을 보장하기 위해 Node.js 경로 메서드를 사용합니다.
• 저널 항목 및 기타 데이터는 플랫폼에 독립적인 형식으로 저장됩니다.

개발 워크플로

• NPM 스크립트는 모든 플랫폼에서 작동합니다.
• TypeScript 컴파일은 플랫폼에 독립적인 JavaScript를 생성합니다.
• 오류 처리에는 플랫폼별 파일 시스템 동작이 포함됩니다.

구현 프레임워크

모듈 아키텍처

이 시스템은 구조화된 출현을 위한 조건을 만드는 모듈식 도구를 중심으로 구축되었습니다.

도구 패턴

각 도구는 고유한 역할을 유지하면서 일관된 패턴을 따릅니다.

• 명확한 인터페이스 정의
• 구조화된 오류 처리
• 국가 관리
• 모듈 간 상호 작용

개발 환경

• 유형 안전을 위한 TypeScript
• 모듈 기반 조직
• 종합 로깅
• 작업 공간 컨텍스트 관리

이론적 기초

개인 지능 프레임워크

PIF는 다음을 기반으로 한 인간-AI 협업에 대한 새로운 접근 방식을 나타냅니다.

• 구조화된 출현을 위한 조건 만들기
• 프레임워크 기반 연속성 유지
• 진보적 발전 지원
• 의미 있는 상호작용을 가능하게 하다

구조화된 출현

고정된 패턴을 규정하는 대신, 구현을 통해 이해가 다음을 통해 나타날 수 있는 제한된 공간을 만듭니다.

• 도구 매개 상호작용
• 관계 구조
• 시간 공간
• 점진적인 발전

프레임워크 기반 연속성

이해는 다음을 통해 발전합니다.

• 구조화된 문서
• 패턴 발견
• 역사적 맥락
• 진화적 발전

점진적 공개

이 시스템은 다양한 수준의 참여를 지원합니다.

• 즉각적인 실용성
• 패턴 발견
• 프레임워크 진화
• 철학적 정렬

개발 경로

도구 사용자

실제 구현에 주로 관심이 있는 분들을 위해:

1. 기본 도구 사용부터 시작하세요
2. 모듈 문서 탐색
3. 상호작용 패턴 개발
4. 새로운 역량을 발견하세요

프레임워크 개발자

시스템 확장에 관심이 있는 분들을 위해:

1. 모듈 아키텍처 검토
2. 도구 패턴 이해
3. 새로운 기능 구현
4. 프레임워크 정렬 유지

이론 탐험가

더 심층적인 패턴에 관심이 있는 분들을 위해:

1. 연구 실행 원칙
2. 새로운 패턴을 관찰하세요
3. 프레임워크 진화에 기여
4. 새로운 이해를 개발하다

기여하다

이 프로젝트는 구현과 이론적 측면을 모두 다루는 기여를 환영합니다.

• 도구 개발
• 문서 개선
• 패턴 발견
• 프레임워크 진화

선적 서류 비치

포괄적인 문서가 제공됩니다.

• 모듈 문서 : 개별 도구 문서
• 아키텍처 가이드 : 시스템 설계 및 패턴
• 개발 가이드 : 구현 패턴

미래 방향

이 프로젝트는 다음을 통해 계속 발전하고 있습니다.

• 새로운 도구 개발
• 패턴 발견
• 프레임워크 개선
• 커뮤니티 참여

철학

이 구현은 다음과 같은 뷰를 구현합니다.

• 이해는 구조화된 상호작용을 통해 나타납니다.
• 도구는 새로운 패턴을 위한 공간을 만듭니다.
• 개발 자체가 철학적 탐구가 됩니다.
• 인간과 AI의 지능은 함께 진화한다

사용에 대한 참고 사항

이 시스템은 단순한 도구 모음을 넘어, 인간과 AI의 지능이 구조화된 상호작용을 통해 어떻게 발전할 수 있는지 탐구하는 공간입니다. 각 세션은 새로운 이해와 협업 패턴을 발견할 수 있는 기회입니다.