vybenetwork/solana-mcp-vybe

이 프로젝트는 무엇인가요?

Vybe의 Solana MCP는 AI 기반 코딩 어시스턴트(Cursor, Claude, Codex 등)가 Solana 블록체인과 통신할 수 있도록 해주는 공개 서버입니다. 이 프로젝트는 Model Context Protocol (MCP)를 구현하여, 어시스턴트가 내장 도구처럼 사용할 수 있는 단일 HTTP 스트림을 통해 Solana의 API 엔드포인트를 노출합니다.

어떻게 작동하나요?

MCP 엔드포인트 – 모든 요청은 다음 URL로 전송됩니다:
```
https://mcp.vybenetwork.xyz/mcp
```
동일한 URL은 공식 MCP 레지스트리(server.json)에도 기재되어 있습니다.
클라이언트 설정 – 다양한 AI 클라이언트는 미세한 JSON 스니펫이 필요합니다:
- Cursor / Windsurf / Codex 스타일 – mcpServers 아래에 type: "http"와 위의 URL을 추가합니다.
- Claude 데스크톱 – npx mcp-remote https://mcp.vybenetwork.xyz/mcp를 실행합니다.
- Claude 커넥터 디렉터리 – 이름과 URL만 제공하면 됩니다.
- Claude Code / Cowork 플러그인 – 리포지토리에는 /.claude-plugin/plugin.json 매니페스트가 포함되어 있으며, 검증 및 제출이 가능합니다.
리포지토리에 시크릿이 포함되지 않음 – 모든 설정은 공개 엔드포인트를 가리키며, AI 클라이언트가 프롬프트를 표시할 때만 인증합니다.

AI 어시스턴트가 할 수 있는 일

이 리포지토리는 MCP 서버가 제공하는 일련의 도구를 정의합니다:

도구	기능
`list-endpoints`	Solana API의 모든 경로, HTTP 메서드 및 간단한 설명을 표시합니다.
`search-endpoints`	키워드와 일치하는 경로, 작업 또는 스키마를 검색합니다.
`get-endpoint`	특정 경로/메서드에 대한 완전한 OpenAPI 설명을 반환합니다.
`query-vybe-api`	`/v4` Solana 엔드포인트 중 어떤 곳이든 인증된 GET 요청을 실시간으로 수행합니다.
`query-vybe-api-batch`	위와 동일하지만, 한 번에 여러 지갑을 읽을 수 있습니다.
`build-vybe-transaction`	토큰 스왑, 계정 닫기, MEV 인출 등의 작업을 위한 서명되지 않은 페이로드를 생성합니다.
`pay-with-x402`	API 사용을 위한 x402 지불 모델(요청당 지불) 사용 방법에 대한 안내를 제공합니다.

이 도구들을 통해 AI 모델은 Solana API를 탐색하고, 블록체인 데이터를 가져오며, 사용자가 나중에 서명하고 제출할 수 있는 트랜잭션 페이로드를 구성할 수 있습니다.

리포지토리 내용 (README에 설명됨)

server.json – GitHub Action을 통해 공식 MCP 레지스트리에 게시되는 메타데이터입니다. 서버 이름(io.github.vybenetwork/solana-mcp-vybe), 버전, 공개 URL을 포함합니다.
.mcp.json / mcp.json – 디렉터리 UI(예: Cursor의 "플러그인 제출")에서 사용되는 루트 설정 파일입니다. 동일한 HTTP 엔드포인트를 가리키며, 시크릿이 포함되지 않습니다.
.codex-plugin/plugin.json – Codex 스타일 로컬 플러그인용 매니페스트입니다.
.claude-plugin/plugin.json – Claude Code / Cowork 플러그인용 매니페스트로, 위의 도구들을 설명합니다.
claude-connector-submission.json – Claude 디렉터리에 커넥터를 제출하기 위한 복사 가능한 필드입니다.
chatgpt-app-submission.json – 향후 ChatGPT App 목록용 드래프트 필드입니다.
examples/cursor-mcp.json – Cursor 사용자를 위한 바로 붙여넣기 가능한 스니펫입니다.

새 버전 출시하기

리포지토리에 태그 달기 (GitHub Action이 태그를 읽고 server.json에 씁니다):
```
git tag v1.0.0
git push origin v1.0.0
```
또는 Publish to MCP Registry 워크플로를 수동으로 트리거합니다.
워크플로는 GitHub OIDC를 사용하므로 개인 액세스 토큰이 필요하지 않습니다.

출시 후 다음 명령어로 항목을 확인합니다:

curl -sS "https://registry.modelcontextprotocol.io/v0.1/servers?search=vybenetwork" | jq .

SSO를 강제하는 조직의 경우, README에 설명된 대로 OAuth 접근 권한을 재부여해야 할 수 있습니다.

누가 이 프로젝트를 사용할 수 있나요?

개발자 – AI 어시스턴트가 커스텀 API 래퍼를 작성하지 않고도 온체인 데이터를 쿼리하거나 트랜잭션을 초안 작성하고 싶은 사람.
AI 플랫폼 팀 (Cursor, Claude, Codex 등) – 플러그인 디렉터리에 Solana 지원을 추가하기 위해 즉시 사용 가능한 MCP 서버가 필요한 사람.
이 AI 어시스턴트의 최종 사용자 – "지갑 X의 잔액은 얼마인가요?" 또는 "서명되지 않은 스왑 트랜잭션을 생성해 주세요"와 같은 질문에 모델이 구체적인 응답을 생성할 수 있게 되는 사람.

사용자용 빠른 시작

examples/에서 적절한 JSON 스니펫을 AI 클라이언트 설정에 복사합니다.
클라이언트를 재시작하거나 플러그인을 다시 로드합니다.
채팅에서 list-endpoints 또는 query-vybe-api와 같은 도구를 호출합니다.
클라이언트가 표시하는 인증 프롬프트(OAuth)에 따라 진행합니다. 리포지토리는 키를 전혀 저장하지 않습니다.

README에 언급된 링크

MCP 엔드포인트: https://mcp.vybenetwork.xyz/mcp
레지스트리 메타데이터: https://mcp.vybenetwork.xyz
문서 사이트: https://docs.vybenetwork.com/docs/mcp
Cursor Directory: https://cursor.directory
공식 MCP 레지스트리: https://registry.modelcontextprotocol.io

요약

Vybe의 Solana MCP는 Model Context Protocol를 통해 현대의 AI 코딩 어시스턴트가 Solana 블록체인과 상호작용할 수 있도록 해주는 작지만 기능적인 오픈소스 브리지입니다. 주요 AI 플랫폼용 준비된 설정 파일, 유용한 Solana 중심의 도구, 그리고 공개 서버 목록을 최신 상태로 유지하는 자동화된 패키징 파이프라인을 제공합니다.