모델 컨텍스트 프로토콜 TypeScript 구현
개요
이 프로젝트는 개인 지능 프레임워크(PIF)의 실질적인 구현체로서 모델 컨텍스트 프로토콜(MCP)을 구현합니다. 체계적인 도구와 점진적인 상호작용 패턴을 통해 인간과 AI 간의 의미 있는 이해를 위한 공간을 조성합니다.
빠른 시작
필수 조건
- Node.js 18+ 및 npm
- 타입스크립트 5.0+
- 모델 컨텍스트 프로토콜 TypeScript SDK
- 사용자 정의 서버에 맞게 구성된 Claude Desktop Client
참고 : 이 구현은 Windows와 macOS/Linux 시스템 모두에서 테스트되었습니다.
설정
- 저장소를 복제합니다.
지엑스피1
- 종속성 설치:
- 서버를 구성하세요:
- 이제 구성은 기본적으로 자동 감지되지만 다음을 사용자 정의할 수 있습니다.
MCP_WORKSPACE_ROOT 환경 변수를 설정하여 작업 공간 위치를 지정합니다.- 또는 구성 옵션의 JSON 문자열로
MCP_CONFIG 환경 변수를 설정합니다. - 또는
src/config.ts 직접 편집하여 기본 구성을 수정합니다.
- 서버를 빌드하세요:
- 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 실제 저장소 경로로 바꾸세요.- 경로는 운영 체제에 맞게 자동으로 정규화됩니다.
- Claude 데스크톱 클라이언트 연결:
- Claude Desktop Client를 시작하거나 다시 시작합니다.
- 사용자 지정 서버로 "mcp-pif"를 선택하세요
- 서버 사용을 시작하려면 새 채팅을 시작하세요.
디렉토리 구조
서버는 구성된 작업 공간에서 다음 구조를 만들고 관리합니다.
workspace/
├── home/
│ ├── meta/
│ │ └── journal/ # For storing journal entries
│ └── projects/ # For user projects
다음 단계
문제 해결
- 경로를 수동으로 지정하는 경우 플랫폼에 적합한 구분 기호(Windows에서는 백슬래시, macOS/Linux에서는 슬래시)를 사용하세요.
- 연결이 실패하면 Claude Desktop Client 로그를 확인하세요.
- 작업 공간 디렉토리가 존재하고 쓰기 가능한지 확인하세요.
- Node.js 및 TypeScript 버전이 요구 사항을 충족하는지 확인하세요.
핵심 구현
사용 가능한 도구
구현에서는 구조화된 상호작용을 지원하도록 설계된 핵심 도구 세트를 제공합니다.
- 파일 시스템 작업 : 작업 공간 컨텍스트 탐색 및 관리
pwd , cd , read , write , mkdir , delete , move , rename
- 추론 도구 : 체계적인 사고를 위한 공간 만들기
reason : 연결된 통찰력을 개발합니다think : 묵상을 위한 시간적 공간을 만들다
- 저널 시스템 : 프레임워크 연속성 유지
journal_create : 문서 개발journal_read : 패턴 탐색
기본 사용법
// Create a structured thought pattern
reason: {
thoughts: [
{ content: "Initial observation" },
{
content: "Building on previous thought",
relationType: "sequence",
relationTo: 0
}
]
}
// Document development
journal_create: {
title: "Implementation Pattern",
content: "Insights about development...",
tags: ["development", "patterns"]
}
크로스 플랫폼 지원
MCP-PIF 서버는 Windows, macOS, Linux 환경에서 원활하게 작동하도록 설계되었습니다.
경로 처리
- 모든 파일 경로는 현재 운영 체제에 맞게 자동으로 정규화됩니다.
- 작업 공간 루트는 현재 환경에 따라 자동으로 감지됩니다.
- 작업 공간 내에서는 절대 경로와 상대 경로가 모두 지원됩니다.
구성
- 환경 변수는 서버를 구성하는 크로스 플랫폼 방식을 제공합니다.
- 파일 작업은 일관된 동작을 보장하기 위해 Node.js 경로 메서드를 사용합니다.
- 저널 항목 및 기타 데이터는 플랫폼에 독립적인 형식으로 저장됩니다.
개발 워크플로
- NPM 스크립트는 모든 플랫폼에서 작동합니다.
- TypeScript 컴파일은 플랫폼에 독립적인 JavaScript를 생성합니다.
- 오류 처리에는 플랫폼별 파일 시스템 동작이 포함됩니다.
구현 프레임워크
모듈 아키텍처
이 시스템은 구조화된 출현을 위한 조건을 만드는 모듈식 도구를 중심으로 구축되었습니다.
src/
├── core/ # Framework foundations
├── mcp_modules/ # Tool implementations
└── api/ # External integrations
도구 패턴
각 도구는 고유한 역할을 유지하면서 일관된 패턴을 따릅니다.
- 명확한 인터페이스 정의
- 구조화된 오류 처리
- 국가 관리
- 모듈 간 상호 작용
개발 환경
- 유형 안전을 위한 TypeScript
- 모듈 기반 조직
- 종합 로깅
- 작업 공간 컨텍스트 관리
이론적 기초
개인 지능 프레임워크
PIF는 다음을 기반으로 한 인간-AI 협업에 대한 새로운 접근 방식을 나타냅니다.
- 구조화된 출현을 위한 조건 만들기
- 프레임워크 기반 연속성 유지
- 진보적 발전 지원
- 의미 있는 상호작용을 가능하게 하다
구조화된 출현
고정된 패턴을 규정하는 대신, 구현을 통해 이해가 다음을 통해 나타날 수 있는 제한된 공간을 만듭니다.
- 도구 매개 상호작용
- 관계 구조
- 시간 공간
- 점진적인 발전
프레임워크 기반 연속성
이해는 다음을 통해 발전합니다.
점진적 공개
이 시스템은 다양한 수준의 참여를 지원합니다.
- 즉각적인 실용성
- 패턴 발견
- 프레임워크 진화
- 철학적 정렬
개발 경로
도구 사용자
실제 구현에 주로 관심이 있는 분들을 위해:
- 기본 도구 사용부터 시작하세요
- 모듈 문서 탐색
- 상호작용 패턴 개발
- 새로운 역량을 발견하세요
프레임워크 개발자
시스템 확장에 관심이 있는 분들을 위해:
- 모듈 아키텍처 검토
- 도구 패턴 이해
- 새로운 기능 구현
- 프레임워크 정렬 유지
이론 탐험가
더 심층적인 패턴에 관심이 있는 분들을 위해:
- 연구 실행 원칙
- 새로운 패턴을 관찰하세요
- 프레임워크 진화에 기여
- 새로운 이해를 개발하다
기여하다
이 프로젝트는 구현과 이론적 측면을 모두 다루는 기여를 환영합니다.
선적 서류 비치
포괄적인 문서가 제공됩니다.
미래 방향
이 프로젝트는 다음을 통해 계속 발전하고 있습니다.
- 새로운 도구 개발
- 패턴 발견
- 프레임워크 개선
- 커뮤니티 참여
철학
이 구현은 다음과 같은 뷰를 구현합니다.
- 이해는 구조화된 상호작용을 통해 나타납니다.
- 도구는 새로운 패턴을 위한 공간을 만듭니다.
- 개발 자체가 철학적 탐구가 됩니다.
- 인간과 AI의 지능은 함께 진화한다
사용에 대한 참고 사항
이 시스템은 단순한 도구 모음을 넘어, 인간과 AI의 지능이 구조화된 상호작용을 통해 어떻게 발전할 수 있는지 탐구하는 공간입니다. 각 세션은 새로운 이해와 협업 패턴을 발견할 수 있는 기회입니다.