Chronos MCP Server

크로노스 MCP 서버 🔵

Chronos는 Stellar 블록체인에 맞춰 설계된 모델 컨텍스트 프로토콜(MCP) 서버로, Claude Desktop 및 유사 AI 애플리케이션과의 통합을 위해 특별히 설계되었습니다. Chronos는 온체인 도구를 통해 AI 비서가 Stellar 네트워크와의 원활한 상호작용을 할 수 있도록 지원합니다.

개요

Chronos MCP는 다음과 같은 기능을 제공합니다.

• Stellar 지갑에 연결: 비밀 키를 사용하여 지갑에 안전하게 연결하세요.
• 지갑 토큰 목록: Stellar 지갑에 보관된 모든 토큰을 검색하여 나열합니다.
• 잔액 조회: XLM 및 기타 자산의 실시간 잔액을 확인하세요.
• 자금 이체: Stellar 지갑 간에 간편하게 자금 이체를 시작하세요.

Chronos는 확장 가능하도록 만들어졌으며 표준 Node.js 패키지로 작동하므로 다른 MCP 서버(예: base-mcp)와 유사하게 쉽게 배포, 설치 및 통합할 수 있습니다.

특징

• Stellar 통합: Horizon API를 통해 Stellar 메인넷과 완벽하게 상호 작용합니다.
• 간편한 배포: npm을 사용하여 Chronos를 게시하고 설치합니다.
• Claude Desktop 호환성: MCP 서버 구성을 업데이트하여 Claude Desktop과 원활하게 통합합니다.
• 확장 가능한 아키텍처: 향후 개선 및 새로운 도구 통합을 위해 설계되었습니다.

필수 조건

• Node.js(v14 이상)
• 엔피엠
• Stellar 지갑 자격 증명(연결을 위한 비밀 키)
• Stellar 네트워크와 상호 작용하기 위한 인터넷 연결

설치

옵션 1: npm에서 설치(권장)

Chronos를 전역으로 설치하세요:

지엑스피1

또는 npx와 함께 직접 사용하세요:

옵션 2: 소스에서 설치

1. 저장소를 복제합니다.
   git clone https://github.com/yourusername/chronos-mcp.git cd chronos-mcp
2. 종속성 설치:
   npm install
3. 프로젝트를 빌드하세요:
   npm run build
4. (선택 사항) 더 쉽게 액세스할 수 있도록 글로벌 링크:
   npm link

옵션 3: Docker 사용

Docker를 사용하여 Chronos MCP를 실행할 수도 있습니다.

1. Docker 이미지를 빌드합니다.
   docker build -t chronos-mcp .
2. 컨테이너를 실행합니다.
   docker run -it --rm chronos-mcp

Claude Desktop과 Docker Compose 설정 및 통합을 포함하여 Chronos MCP와 함께 Docker를 사용하는 방법에 대한 자세한 지침은 Docker 사용 가이드를 참조하세요.

Docker 설정이 로컬에서 작동하는지 테스트하려면 Docker 테스트 가이드 의 단계별 지침을 따르세요. 이 가이드에는 Docker 이미지 빌드, 컨테이너 실행 및 기능 테스트에 대한 지침이 포함되어 있습니다.

구성

환경 변수

Chronos MCP는 구성, 특히 Stellar 비밀 키와 같은 민감한 정보의 경우 환경 변수를 사용합니다. 이 프로젝트는 개발 과정에서 dotenv 사용하여 .env 파일에서 환경 변수를 불러옵니다.

환경 변수를 구성하려면:

1. 프로젝트 루트에 .env 파일을 만듭니다.
   STELLAR_SECRET_KEY=your_stellar_secret_key STELLAR_NETWORK=mainnet
2. 이러한 변수는 애플리케이션이 시작될 때 자동으로 로드됩니다.

Docker를 사용할 때 여러 가지 방법으로 환경 변수를 제공할 수 있습니다.

• --env-file 플래그 사용: docker run -it --rm --env-file .env chronos-mcp
• docker-compose.yml에서 env_file 지시어 사용
• -e 플래그를 사용하여 개별 변수 설정: docker run -it --rm -e STELLAR_SECRET_KEY=your_key chronos-mcp

클로드 데스크톱 구성

Claude Desktop과 함께 Chronos를 사용하려면 다음 위치에 있는 Claude Desktop 구성 파일을 업데이트하세요.

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• 리눅스: ~/.config/Claude/claude_desktop_config.json

Claude Desktop에 대한 샘플 구성:

Claude Desktop과 Docker를 통합하려면 다음을 사용할 수 있습니다.

용법

Chronos MCP는 MCP 인터페이스를 통해 다음 도구를 제공합니다.

커넥트_월렛

비밀 키를 사용하여 Stellar 지갑에 연결합니다.

예제 명령:

"비밀 키 ______를 사용하여 내 지갑을 연결하세요"

리스트_토큰

지정된 Stellar 지갑에 있는 모든 토큰과 자산을 나열합니다.

예제 명령:

"내 지갑 토큰 목록"

잔액 가져오기

XLM 및 기타 자산의 잔액을 검색합니다.

예제 명령:

"현재 내 XLM 잔액은 얼마인가요?"

자금 이체

귀하의 지갑에서 다른 Stellar 지갑으로 자금을 이체합니다.

매개변수:

• secretKey : 지갑 비밀 키.
• destinationAddress : 수신자의 지갑 주소.
• amount : 이체할 금액.
• asset(선택 사항) : 전송할 자산(기본값은 XLM)

예제 명령:

"[대상 지갑 주소]로 0.5 XLM을 이체하세요."

테스트

표준 테스트

로컬에서 Chronos MCP를 테스트하려면:

이렇게 하면 프로젝트 테스트 모음이 실행되고 서버가 예상대로 작동하는지 확인됩니다.

도커 테스팅

Docker 설정을 로컬에서 테스트하려면 Docker 테스트 가이드 에서 자세한 지침을 참조하세요. 가이드에는 다음 내용이 포함됩니다.

• Docker 이미지 빌드
• Docker Compose로 컨테이너 실행
• 컨테이너 기능 테스트
• 일반적인 문제 해결

포함된 test-client.js 스크립트를 사용하여 Docker 컨테이너를 테스트할 수도 있습니다.

이 스크립트는 Docker 컨테이너에 간단한 MCP 요청을 보내고 응답을 표시합니다.

전개

Chronos MCP는 표준 Node.js 패키지로 작동하도록 설계되었으며 npm에 게시할 수 있습니다. 게시된 후에는(예: npm publish ) 다른 MCP 서버와 마찬가지로 Chronos를 전역으로 설치하거나 npx를 통해 사용할 수 있습니다.

실제 운영에 배포하는 경우, 자동 재시작 및 모니터링을 위해 Chronos를 시스템 서비스(systemd, launchd 등 사용)로 래핑하는 것을 고려하세요.

크로노스 확장

Chronos는 확장성을 염두에 두고 제작되었습니다. 새로운 도구를 추가하려면 다음을 수행하세요.

1. src/tools 폴더에 새 디렉토리를 만듭니다.
2. 도구를 구현합니다( index.ts , schemas.ts , handlers.ts 포함).
3. src/tools/index.ts 로 도구를 내보냅니다.
4. README에 도구 설명서와 예제를 추가하세요.
5. 새로운 도구가 제대로 작동하는지 확인하기 위해 테스트를 작성하세요.

특허

이 프로젝트는 MIT 라이선스 에 따라 라이선스가 부여되었습니다.

기여하다

기여를 환영합니다! 문제 보고, 풀 리퀘스트 제출 및 기타 기여 지침은 CONTRIBUTING.md 를 참조하세요.

────────────────────────────── 이 README는 Chronos MCP에 맞춰 특별히 작성되었으며, Node.js 패키지로서의 배포, Claude Desktop과의 통합, Stellar 블록체인과 상호 작용하는 포괄적인 기능 세트에 대한 개요를 설명합니다.