MPC Tally API 서버

Tally API와 상호 작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 AI 에이전트는 DAO에 대한 정보(거버넌스 데이터, 제안, 메타데이터 포함)를 가져올 수 있습니다.

특징

• 인기 또는 탐색 상태별로 정렬된 DAO 목록

• 소셜 링크 및 거버넌스 정보를 포함한 포괄적인 DAO 메타데이터를 가져옵니다.

• 대용량 결과 집합을 처리하기 위한 페이지 매김 지원

• TypeScript 및 GraphQL로 구축됨

• Bun의 테스트 러너를 사용한 전체 테스트 범위

Related MCP server: mcp-graphql

설치

지엑스피1

구성

1. 루트 디렉토리에 .env 파일을 만듭니다.

TALLY_API_KEY=your_api_key_here

2. Tally 에서 API 키를 받으세요

⚠️ 보안 참고 사항 : API 키를 안전하게 보관하세요.

• .env 파일을 커밋하지 마세요

• 로그나 오류 메시지에 API 키를 노출하지 마세요.

• API 키가 노출된 경우 회전하세요.

• 구성을 위해 환경 변수를 사용하세요

용법

서버 실행

# Start the server
bun run start

# Development mode with auto-reload
bun run dev

클로드 데스크톱 구성

Claude Desktop 구성에 다음을 추가하세요.

{
  "tally": {
    "command": "node",
    "args": [
      "/path/to/mpc-tally-api-server/build/index.js"
    ],
    "env": {
      "TALLY_API_KEY": "your_api_key_here"
    }
  }
}

사용 가능한 스크립트

• bun run clean - 빌드 디렉토리 정리

• bun run build - 프로젝트 빌드

• bun run start - 빌드된 서버를 실행합니다.

• bun run dev - 자동 재로드를 통해 개발 모드로 실행

• bun test - 테스트 실행

• bun test --watch - watch 모드에서 테스트 실행

• bun test --coverage - 커버리지를 포함한 테스트 실행

API 함수

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

리스트_다오스

지정된 기준에 따라 정렬된 DAO를 나열합니다.

매개변수:

• limit (선택 사항): 반환할 DAO의 최대 수(기본값: 20, 최대값: 50)

• afterCursor (선택 사항): 페이지 매김을 위한 커서

• sortBy (선택 사항): DAO를 정렬하는 방법(기본값: 인기)

  • 옵션: "id", "name", "explore", "popular"

특허

MIT