Alchemy MCP 서버

AI 에이전트가 Alchemy의 블록체인 API와 구조화된 방식으로 상호작용할 수 있게 해주는 MCP(Model Context Protocol) 서버입니다. 이를 통해 에이전트는 코드를 작성하지 않고도 블록체인 데이터를 직접 쿼리할 수 있습니다.

원격 MCP 서버 (권장)

가장 빠르게 시작하는 방법은 호스팅된 원격 서버 https://mcp.alchemy.com/mcp에 연결하는 것입니다. OAuth를 통해 인증하며, 메시지가 표시되면 Alchemy 계정으로 로그인하기만 하면 됩니다. API 키나 로컬 설치가 필요하지 않습니다.

전체 문서: alchemy.com/docs/alchemy-mcp-server

참고: mcp.alchemy.com의 호스팅 서버와 이 오픈 소스 저장소는 별도로 유지 관리되므로 동기화되지 않을 수 있습니다.

{
  "mcpServers": {
    "alchemy": {
      "type": "streamable-http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

{
  "servers": {
    "alchemy": {
      "type": "http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

다른 MCP 호환 클라이언트의 경우, Streamable HTTP 전송을 사용하여 https://mcp.alchemy.com/mcp를 가리키도록 설정하십시오.

Related MCP server: Substrate MCP Server

로컬 STDIO 서버

이 MCP 서버는 AI 에이전트와 Alchemy의 블록체인 API 간의 가교 역할을 하여 에이전트가 다음을 수행할 수 있도록 합니다:

• 토큰 가격 및 가격 기록 쿼리 (유연한 기간 쿼리 포함)

• NFT 소유권 정보 및 컨트랙트 데이터 가져오기

• 여러 네트워크에 걸친 트랜잭션 기록 보기

• 여러 블록체인 네트워크에 걸친 토큰 잔액 확인

• 필터링을 통한 상세 자산 전송 내역 검색

• 스마트 컨트랙트 계정을 통한 트랜잭션 전송 (구성된 지갑 에이전트 서버 필요)

• DEX 프로토콜을 통한 토큰 스왑 실행 (구성된 지갑 에이전트 서버 필요)

• 기타 등등!

빠른 설정

MCP 서버를 빠르게 설정하려면 MCP 구성 파일(일반적으로 Claude Desktop 또는 Cursor 설정)에 다음 구성을 사용하십시오:

{
  "mcpServers": {
    "alchemy": {
      "command": "npx",
      "args": ["-y", "@alchemy/mcp-server"],
      "env": {
        "ALCHEMY_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

이 구성을 사용하면 저장소를 수동으로 복제하지 않고도 서버를 사용할 수 있습니다.

환경 변수

MCP 서버는 다음 환경 변수가 필요합니다:

• ALCHEMY_API_KEY - Alchemy API 키 (모든 블록체인 데이터 쿼리에 필수)

트랜잭션 및 스왑 기능을 사용하려면 다음도 구성해야 합니다:

• AGENT_WALLET_SERVER - 스마트 컨트랙트 계정 작업을 처리하는 구성된 지갑 에이전트 서버의 URL

⚠️ 중요: sendTransaction 및 swap 메서드는 적절하게 구성된 지갑 에이전트 서버 없이는 작동하지 않습니다. 이러한 메서드는 트랜잭션 서명 및 브로드캐스팅을 처리하기 위해 외부 지갑 인프라가 필요합니다.

사용 가능한 메서드

AI 에이전트에게 다음 메서드를 사용하도록 프롬프트를 보낼 수 있습니다:

토큰 가격 메서드

1. fetchTokenPriceBySymbol

   • 심볼별 토큰의 현재 가격 데이터 가져오기

   • 예: "ETH와 BTC의 현재 가격은 얼마야?"

2. fetchTokenPriceByAddress

   • 컨트랙트 주소별 토큰의 현재 가격 데이터 가져오기

   • 예: "이더리움 메인넷에서 0x1234...5678 주소의 토큰 가격은 얼마야?"

3. fetchTokenPriceHistoryBySymbol

   • 특정 날짜 범위의 토큰 과거 가격 데이터 가져오기

   • 예: "2023년 1월 1일부터 2월 1일까지 BTC 가격 기록을 일별 간격으로 보여줘"

4. fetchTokenPriceHistoryByTimeFrame

   • 유연한 기간 또는 자연어를 사용하여 과거 가격 데이터 가져오기

   • 예: "지난주 ETH 가격 보여줘" 또는 "지난 30일간 BTC 가격 가져와"

멀티체인 토큰 메서드

5. fetchTokensOwnedByMultichainAddresses

   • 여러 네트워크에 걸친 주소의 토큰 잔액 가져오기

   • 예: "0xabc...123 주소가 이더리움과 Base에서 보유한 토큰은 뭐야?"

트랜잭션 기록 메서드

6. fetchAddressTransactionHistory

   • 여러 네트워크에 걸친 주소의 트랜잭션 기록 가져오기

   • 예: "이더리움에서 0xdef...456 지갑의 최근 트랜잭션 보여줘"

7. fetchTransfers

   • 고급 필터링 옵션을 사용하여 상세 자산 전송 데이터 가져오기

   • 예: "0xghi...789로 오거나 나간 모든 ERC-20 전송 내역을 보여줘"

NFT 메서드

8. fetchNftsOwnedByMultichainAddresses

   • 스팸 필터링을 적용하여 주소가 소유한 모든 NFT 가져오기

   • 예: "0xjkl...012가 소유한 NFT는 뭐야?"

9. fetchNftContractDataByMultichainAddress

   • 주소에 대한 NFT 컨트랙트 데이터 가져오기

   • 예: "0xmno...345는 어떤 NFT 컬렉션의 토큰을 가지고 있어?"

트랜잭션 메서드

10. sendTransaction

    • 스마트 컨트랙트 계정을 통해 트랜잭션 전송

    • ⚠️ 중요: AGENT_WALLET_SERVER 환경 변수가 설정된 구성된 지갑 에이전트 서버가 필요합니다.

    • 예: "0.1 ETH를 0xpqr...678로 보내줘"

스왑 메서드

11. swap

    • DEX 프로토콜(Uniswap)을 통해 토큰 스왑 실행

    • ⚠️ 중요: AGENT_WALLET_SERVER 환경 변수가 설정된 구성된 지갑 에이전트 서버가 필요합니다.

    • 예: "100 USDC를 ETH로 스왑해줘"

로컬 개발 및 오픈 소스 기여

설치

1. 저장소 복제

git clone https://github.com/alchemyplatform/alchemy-mcp.git
cd alchemy-mcp

2. 의존성 설치

pnpm install

개발

pnpm watch

프로덕션용 빌드

pnpm build

디버깅을 위한 MCP Inspector 사용

MCP Inspector는 메서드를 테스트할 수 있는 시각적 인터페이스를 제공하여 MCP 서버를 디버깅하는 데 도움을 줍니다:

pnpm inspector

이 명령은 브라우저에서 액세스할 수 있는 MCP Inspector를 시작합니다. 이를 통해 다음을 수행할 수 있습니다:

• 사용 가능한 모든 메서드 확인

• 다양한 매개변수로 메서드 테스트

• 응답 데이터 보기

• MCP 서버 문제 디버깅

기여

풀 리퀘스트를 환영합니다. 주요 변경 사항의 경우, 먼저 이슈를 열어 변경하고 싶은 내용을 논의해 주십시오.

라이선스

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 이는 MIT 라이선스의 약관에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있음을 의미합니다.

예시 프롬프트

AI 에이전트와 함께 사용할 수 있는 몇 가지 예시 프롬프트입니다:

What's the current price of Bitcoin and Ethereum?

Show me the NFTs owned by the wallet 0x1234...5678 on Ethereum.

What tokens does wallet 0xabcd...6789 hold across Ethereum and Base?

Get me the transaction history for 0x9876...5432.

Show me the price history of Ethereum from January 1st to today with daily intervals.

Get me Bitcoin price data for the last week with hourly intervals.

Show me ETH price performance for the past month.

What ERC-20 transfers happened to address 0x1234...5678 in the last 100 blocks?

API 참조

Alchemy API에 대한 자세한 내용은 다음을 참조하십시오:

• Alchemy API 문서