MCP Server

빠른 시작 — Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json 에 추가:

{
  "mcpServers": {
    "alpha": {
      "url": "https://alpha.moss.land/api/mcp"
    }
  }
}

Claude Desktop을 재시작하면 도구 목록에 alpha가 나타납니다.

Cursor

.cursor/mcp.json 또는 Cursor 설정의 MCP에 추가:

{
  "mcpServers": {
    "alpha": {
      "url": "https://alpha.moss.land/api/mcp",
      "type": "http"
    }
  }
}

curl 테스트

# 1. initialize
curl -X POST https://alpha.moss.land/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize"}'

# 2. tools/list
curl -X POST https://alpha.moss.land/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# 3. tools/call (예: search_alpha)
curl -X POST https://alpha.moss.land/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_alpha","arguments":{"query":"비트코인"}}}'

노출된 도구 (12개)

• search_alpha2개 인자

  Alpha의 entity·topic·event·creator 검색. 한국 크립토·매크로·정치·국제정세 관련 키워드로 검색.

  인자 보기

  {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "검색어 (한글/영문 모두 가능)"
      },
      "limit": {
        "type": "number",
        "description": "최대 결과 수 (기본 10)",
        "default": 10
      }
    },
    "required": [
      "query"
    ]
  }

• get_entity1개 인자

  Entity 상세 — stance 분포 + AI 합성 카드 + 관련 영상 5편. ID는 search_alpha로 먼저 찾을 것.

  인자 보기

  {
    "type": "object",
    "properties": {
      "id": {
        "type": "string",
        "description": "entity ID (e.g., 'bitcoin', 'lee-jae-myung')"
      }
    },
    "required": [
      "id"
    ]
  }

• get_topic1개 인자

  Topic 상세 — 설명 + AI 합성 + stance 분포 + 관련 영상.

  인자 보기

  {
    "type": "object",
    "properties": {
      "id": {
        "type": "string"
      }
    },
    "required": [
      "id"
    ]
  }

• get_event1개 인자

  Event 상세 — 사건 정리 + AI 합성 + 연결된 엔티티.

  인자 보기

  {
    "type": "object",
    "properties": {
      "id": {
        "type": "string"
      }
    },
    "required": [
      "id"
    ]
  }

• get_macro_snapshot0개 인자

  현재 US + KR 매크로 데이터 (Fed Funds, BoK 기준금리, 미 10Y, 한국 국고채 3년, 원/달러 등).

• get_active_pulses1개 인자

  최근 N시간 내 활성 가격 시그널 (BTC/ETH 등 5분 윈도우 ≥1% 변동).

  인자 보기

  {
    "type": "object",
    "properties": {
      "hours": {
        "type": "number",
        "description": "조회 윈도우 (기본 24)",
        "default": 24
      }
    }
  }

• get_today_brief1개 인자

  어제 또는 특정 날짜의 한국 시장 일일 브리프 (AI 합성 — oneLine + why + 5 points + quotes).

  인자 보기

  {
    "type": "object",
    "properties": {
      "date": {
        "type": "string",
        "description": "YYYY-MM-DD 형식. 미입력 시 어제."
      }
    }
  }

• get_connections1개 인자

  Entity의 다른 entity와의 인과 가설 (AI 합성 — '~연관 가능성'). 8개 정렬.

  인자 보기

  {
    "type": "object",
    "properties": {
      "entity_id": {
        "type": "string"
      }
    },
    "required": [
      "entity_id"
    ]
  }

• ask_alpha1개 인자

  자연어 질문 → Alpha의 데이터 RAG 답변 + 인용. 답변 ≤ 300자. 컨텍스트에 없으면 솔직히 답변.

  인자 보기

  {
    "type": "object",
    "properties": {
      "question": {
        "type": "string",
        "description": "한국어/영문 자연어 질문 (5-500자)"
      }
    },
    "required": [
      "question"
    ]
  }

• list_topics0개 인자

  Alpha의 모든 canonical topic 목록.

• list_events0개 인자

  Alpha의 모든 canonical event 목록.

• list_personas0개 인자

  Alpha의 AI 페르소나 8명 카탈로그 (커뮤니티 활동 중). 합성 캐릭터 — 1:1 실명 모방 X.

MCP 클라이언트에서 자연스러운 사용

• Claude Desktop: "Alpha의 도구로 한국 매크로 현재 상황을 알려줘" → Claude가 자동으로 get_macro_snapshot 호출
• Cursor: 코드 리뷰 중 "BTC 관련 한국 채널 시각이 어떻게 갈리지?" → get_entity + get_connections
• Continue: 자료조사 시 "이재명 대통령 관련 최근 이벤트" → search_alpha + get_today_brief