Grok AI MCP Server

Grok AI MCP 서버 Grok AI MCP 서버에 오신 것을 환영합니다. 이 서버는 Node.js 기반 서버로, xAI Grok API와 통합되어 솔라나 블록체인을 비롯한 다양한 블록체인에 강력한 AI 기반 분석 도구를 제공합니다. 이 서버는 모델 컨텍스트 프로토콜(MCP)을 활용하여 Grok의 고급 기능(비전 포함)을 활용하여 거래, 주소, 이미지 및 일반 쿼리를 분석하는 도구 세트를 제공합니다.

개요 Grok AI MCP 서버는 다음을 위해 설계되었습니다.

Solana 블록체인 거래 및 주소를 상세한 인사이트로 분석합니다. Grok의 비전 기능을 사용하여 이미지(base64 또는 URL)를 처리합니다. 선택적 컨텍스트 및 이미지 지원을 통해 일반적인 질문에 답변합니다. MCP SDK를 사용하여 표준 I/O 전송을 통해 운영합니다. 확장성과 사용 편의성을 고려하여 설계된 이 서버는 필요에 따라 추가 도구와 기능을 통해 확장할 수 있습니다.

기능 트랜잭션 분석: Solana 트랜잭션 서명을 분석하고, 스크린샷과 세부 정보를 선택적으로 제공합니다. 주소 분석: Solana 주소를 분석하고, 시각적 데이터를 선택적으로 제공합니다. 이미지 분석: Grok의 비전을 활용하여 사용자 프롬프트를 기반으로 이미지를 해석합니다. 일반 쿼리: Grok에 무엇이든 질문하고, 컨텍스트와 이미지를 지원합니다. 오류 처리: MCP별 오류 코드를 사용하여 강력한 오류 관리 기능을 제공합니다. 표준 입출력(Stdio Transport): 유연한 통합을 위해 표준 입출력(Standard Input/Output)을 지원합니다. 시작하기 필수 조건 Node.js: 버전 16 이상. npm: 노드 패키지 관리자. xAI API 키: Grok API와 상호 작용하기 위해 xAI에서 API 키를 받습니다. Solana 지식: Solana 블록체인 개념에 대한 기본적인 이해가 있으면 도움이 되지만 필수는 아닙니다. 설치 저장소 복제 bash

무너지다

포장하다

git clone https://github.com/yourusername/grok-ai-mcp-server.git 을 복사합니다. cd grok-ai-mcp-server 종속성 설치 bash

무너지다

포장하다

npm install 환경 변수 설정 루트 디렉토리에 .env 파일을 만들고 xAI API 키를 추가합니다. 텍스트

무너지다

포장하다

XAI_API_KEY=your-xai-api-key-here를 복사하여 서버 bash를 실행합니다.

무너지다

포장하다

npm start를 복사합니다. 서버가 시작되고 표준 I/O를 수신합니다. 다음 텍스트가 표시되어야 합니다.

무너지다

포장하다

stdio에서 실행되는 Grok AI MCP 서버 복사 사용법 서버는 MCP 인터페이스를 통해 네 가지 주요 도구를 제공합니다.

1. 거래 분석 도구 이름: analyze_transaction 설명: Solana 거래 서명을 분석합니다. 입력: signature(필수): 거래 서명(문자열). screenshot(선택 사항): Base64로 인코딩된 이미지(문자열). details(선택 사항): 추가 거래 데이터가 포함된 JSON 문자열. 예: json

무너지다

포장하다

복사 { "name": "analyze_transaction", "arguments": { "signature": "5y2...abc", "screenshot": "data:image/jpeg;base64,...", "details": "{"amount": "1.5 SOL", "program": "Tokenkeg..."}" } } 2. 주소 분석 도구 이름: analyze_address 설명: Solana 주소를 분석합니다. 입력: address(필수): Solana 주소(문자열). screenshot(선택 사항): Base64로 인코딩된 이미지(문자열). 예: json

무너지다

포장하다

복사 { "name": "analyze_address", "arguments": { "address": "7xK...xyz", "screenshot": "data:image/jpeg;base64,..." } } 3. 이미지 분석 도구 이름: analyze_image 설명: 사용자가 제공한 프롬프트를 사용하여 이미지를 분석합니다. 입력: prompt(필수): 질문 또는 지시(문자열). image(선택 사항): Base64로 인코딩된 이미지(문자열). image_url(선택 사항): 이미지 URL(문자열). 예: json

무너지다

포장하다

복사 { "name": "analyze_image", "arguments": { "prompt": "이 차트는 무엇을 보여주나요?", "image": "data:image/jpeg;base64,..." } } 4. Grok에 질문하기 도구 이름: ask_grok 설명: Grok에 일반적인 질문을 합니다. 입력: question(필수): 질문할 내용(문자열). context(선택 사항): 추가 컨텍스트(문자열). image(선택 사항): Base64로 인코딩된 이미지(문자열). image_url(선택 사항): 이미지 URL(문자열). 예: json

무너지다

포장하다

복사 { "name": "ask_grok", "arguments": { "question": "Solana의 합의 메커니즘은 무엇인가요?", "context": "블록체인 기술은 처음입니다." } } 서버와의 상호작용 서버는 stdio를 통해 MCP를 사용합니다. MCP 클라이언트를 사용하거나 호환 인터페이스를 통해 JSON 요청을 전송하여 프로그래밍 방식으로 서버와 상호작용할 수 있습니다. 클라이언트 구현에 대한 자세한 내용은 MCP SDK 문서를 참조하세요.

구성 API 키: XAI_API_KEY 환경 변수를 통해 설정합니다. 모델 선택: 서버는 비전 작업에는 grok-2-vision-latest를, 텍스트 전용 쿼리에는 grok-2-latest를 사용합니다. 온도: 창의성과 정확성의 균형을 위해 0.7로 설정합니다(코드에서 조정 가능). 개발 프로젝트 구조 텍스트

무너지다

포장하다

복사 ├── index.js # 메인 서버 코드 ├── package.json # 종속성 및 스크립트 ├── .env # 환경 변수(추적되지 않음) └── README.md # 이 파일 서버 확장 새 도구를 추가하려면 다음을 수행합니다.

ListToolsRequestSchema의 setRequestHandler를 새 도구 정의로 업데이트합니다. CallToolRequestSchema switch 문에 해당 처리기를 추가합니다. 새 메서드(예: handleNewTool)에 처리기 로직을 구현합니다. 오류 처리: 서버는 MCP 오류 코드를 사용합니다.

InvalidParams: 입력이 누락되었거나 잘못되었습니다. MethodNotFound: 알 수 없는 도구가 요청되었습니다. 응답 콘텐츠에 사용자 지정 오류 메시지가 반환됩니다. 기여하기 기여를 환영합니다! 다음을 작성해 주세요.

저장소를 포크합니다. 기능 브랜치를 생성합니다(git checkout -b feature/new-tool). 변경 사항을 커밋합니다(git commit -m "Add new tool"). 브랜치에 푸시합니다(git push origin feature/new-tool). 풀 리퀘스트를 엽니다. 라이선스 이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

감사의 글 본 문서는 Model Context Protocol SDK를 사용하여 작성되었습니다. xAI의 Grok API를 활용했으며, Solana 개발자 커뮤니티에서 영감을 받았습니다. 프로젝트 설정에 맞게 저장소 URL, 라이선스 또는 기타 세부 정보를 자유롭게 수정하세요! 더 세부적으로 수정하고 싶은 부분이 있으면 알려주세요.