iota-agent-mcp: IOTA 블록체인을 위한 MCP (Model Context Protocol) 서버

IOTA 블록체인을 위한 MCP (Model Context Protocol) 서버입니다. AI 코딩 에이전트 (Claude Code, Cursor, VS Code Copilot, ChatGPT)가 IOTA 네트워크와 직접 상호작용할 수 있도록 지원합니다.

3가지 카테고리에 걸친 18개의 도구 (tools):

도구 (Tool)	설명
iota_wallet_address	활성 지갑 주소 가져오기
iota_wallet_balance	IOTA 잔액 확인
iota_wallet_accounts	모든 파생 계정 목록 표시
iota_wallet_sign_execute	트랜잭션 서명 및 실행 (Human-in-the-loop)
iota_wallet_pending	대기 중인 서명 요청 보기
iota_wallet_approve	대기 중인 요청 승인
iota_wallet_reject	대기 중인 요청 거절
iota_wallet_switch_network	메인넷/테스트넷/데브넷 전환

도구 (Tool)	설명
iota_cli	모든 IOTA CLI 명령 실행
iota_move_build	Move 패키지 빌드
iota_move_test_coverage	커버리지 분석과 함께 테스트 실행
iota_move_publish_unsigned	서명되지 않은 게시(publish) 트랜잭션 생성

도구 (Tool)	설명
iota_object	ID별 오브젝트 데이터 가져오기
iota_objects_by_owner	특정 주소가 소유한 오브젝트 목록 표시
iota_transaction	다이제스트(digest)별 트랜잭션 가져오기
iota_coins	주소에 대한 코인 오브젝트 가져오기
iota_epoch_info	현재 에포크(epoch) 및 네트워크 통계 (GraphQL)
iota_decompile	배포된 Move 모듈 디컴파일

┌──────────────────────┐ stdio ┌──────────────────────┐
│ AI Agent (Claude, │ ◀────────────▶ │ iota-agent-mcp │
│ Cursor, VS Code) │ │ (이 서버) │
...

Stateless (무상태)— MCP 프로세스 내에 비밀 정보(secrets)를 저장하지 않음
Human-in-the-loop— 지갑 작업은 승인 흐름이 있는 로컬 에이전트-지갑 서버로 프록시됨
Dual query (이중 쿼리)— 오브젝트/트랜잭션 쿼리에는 JSON-RPC를, 집계 통계에는 GraphQL을 사용
CLI passthrough (CLI 통과)— iota 바이너리를 통해 Move 빌드/테스트/게시 수행

npm install -g iota-agent-mcp

// ~/.claude/settings.json
{
"mcpServers": {
...

// .cursor/mcp.json 또는 .vscode/mcp.json
{
"servers": {
...

환경 변수 (Environment variables):

환경 변수 (Environment variables):

Variable	Default	Description
IOTA_WALLET_SERVER	http://localhost:3847	에이전트 지갑 서버 URL
IOTA_RPC_URL	https://api.mainnet.iota.cafe	IOTA JSON-RPC 엔드포인트
IOTA_GRAPHQL_URL	https://graphql.mainnet.iota.cafe	IOTA GraphQL 인덱서

git clone https://github.com/Scottcjn/iota-agent-mcp.git
cd iota-agent-mcp
npm install
...

Apache-2.0