coin-mcp-server

by pwh-pwh
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Powers the runtime environment for the MCP server, allowing it to execute TypeScript code to fetch cryptocurrency prices

  • Provides input validation for the token parameters to ensure proper request formatting and error handling

코인 MCP 서버 🚀💰

Coin MCP 서버 에 오신 것을 환영합니다. "달까지!"라고 외칠 수 있을 만큼 빠르게 최신 암호화폐 가격을 확인할 수 있는 원스톱 서비스입니다. 🌙 FastMCP 로 구축되고 검증을 위해 zod 가 추가된 이 작은 서버는 Bitget API에서 토큰 가격을 믿음직한 암호화폐 집사처럼 불러옵니다. 🧑‍💼

중국어 문서 | 영어


무슨 역할을 하나요? 🤔

이 프로젝트는 Bitget의 편리한 API를 사용하여 USDT와 페어링된 모든 암호화폐의 현재 가격을 조회할 수 있는 서버를 구축합니다. 지금 당장 좋아하는 토큰의 가치가 궁금하신가요? 질문만 하세요. 짠! 가격이 바로 당신의 것입니다! 💸

  • 도구 : getTokenPrice
  • 미션 : 토큰의 최신 가격을 가져옵니다(예: BGB , BTC , ETH ).
  • 슈퍼파워 : 빠르고 간단하며 FastMCP 로 구동됩니다!⚡
  • 도구 : getAnnoucements
  • 임무 : 공지사항 받기
  • 도구 : getCoinInfo
  • 임무 : 지정된 토큰에 대한 자세한 정보를 얻습니다.
  • Superpower : 토큰 양도 가능성, 지원되는 체인 목록, 체인 네트워크 상태 등의 자세한 정보를 제공합니다.

특징 🌟

  • 🎯 아주 간단한 API : 토큰 심볼을 전달하면 가격을 받아옵니다. 번거로움 없이 간편하게.
  • 🛡️ Zod 검증 : 매개변수는 금고 문보다 더 엄격하게 검사됩니다.
  • 📡 Bitget 통합 : Bitget의 시장 티커 API에서 라이브 데이터를 직접 가져옵니다.
  • 🧠 오류 처리 : 전문가처럼 오류를 잡아내고 나중에 웃을 수 있도록 기록합니다.

시작하기 🏁

암호화폐 가격 풀에 뛰어들 준비가 되셨나요? 시작하는 방법은 다음과 같습니다.

필수 조건

  • Deno : 저희는 고급스럽고 현대적인 앱이기 때문에 Deno를 설치해야 합니다. 여기에서 다운로드하세요.
  • Bitget API 접근 : API 키 필요 없음 - 챔피언처럼 공개 엔드포인트에 접근합니다! 하지만 사용자 지정 BGURL 이 있다면 환경 변수로 설정하세요.

설치

  1. 이 저장소를 최신 상태로 복제하세요.지엑스피1
  2. 종속성을 설치합니다(Deno는 가져오기를 통해 이를 자동으로 처리합니다!).

서버 실행

이것으로 시작해 보세요:

deno run --allow-net --allow-env --allow-read main.ts

또는

deno run --allow-net --allow-env --allow-read https://deno.land/x/coin_mcp_server/main.ts
  • --allow-net : Bitget의 API와 통신할 수 있습니다.
  • --allow-env : BGURL 환경 변수를 설정한 경우 해당 변수를 가져옵니다.

서버는 stdio 모드로 시작하여 암호화폐 자판기처럼 가격을 제공할 준비가 됩니다! 🍔

  1. 설치 없이 지원, deno에 직접 배포, 이 프로젝트 포크, dash.deno.com에 로그인, 환경 변수 StartType=sse를 설정하여 deno에서 제공한 도메인 이름을 사용하여 sse 모드로 연결합니다.

구성

config.json

{ "mcpServers": { "coin-mcp": { "command": "deno", "args": [ "run", "--allow-net", "--allow-read", "--allow-env", "https://deno.land/x/coin_mcp_server/main.ts" ] } } }

사용 예시 🎮

getTokenPrice 호출하는 방법은 다음과 같습니다.

{ "tool": "getTokenPrice", "parameters": { "token": "BGB" } }

응답 :

"42.069" // The latest BGB/USDT price (not a real price, just vibes!)

토큰이 존재하지 않거나 API에 문제가 발생하면 최선을 다했다는 것을 상기시켜주는 뻔뻔스러운 로그와 함께 오류가 발생합니다. 😅


코드 미리 보기 👀

커튼 뒤에 숨겨진 마법은 다음과 같습니다.

  • FastMCP : 멋진 이름과 버전으로 서버를 시작합니다.
  • Zod : token 매개변수를 확인합니다.
  • Bitget API : https://api.bitget.com/api/v2/spot/market/tickers 에서 티커 데이터를 가져옵니다.

getBitgetPrice 함수가 MVP(최종 가격)로, 응답에서 멋진 lastPr (최종 가격)을 가져옵니다. 가격 업데이트나 오류는 로그에서 확인하세요! 😂


환경 변수 🌍

  • BGURL : 사용자 지정 Bitget API 기본 URL(설정하지 않으면 기본적으로 https://api.bitget.com 으로 설정됨). 다음과 같이 설정하세요.
    export BGURL="https://your-custom-bitget-url.com"

문제 해결 🛠️

  • "HTTP 오류! 상태: 404" : 토큰 심볼을 다시 한번 확인하세요. BGBUSDT``BGB 와 다릅니다!
  • "네트워크 오류" : 인터넷과 Deno의 --allow-net 플래그가 있는지 확인하세요.
  • 아직도 막히셨나요? : 허공에 대고 소리치세요(또는 문제를 제기하세요). 함께 해결해 봅시다! 🙌

이것이 존재하는 이유 🎉

실시간으로 암호화폐 가격을 알고 싶지 않은 사람이 있을까요? 트레이더, HODLer, 또는 암호화폐에 관심 있는 분이라면 누구나 이 서버에서 도움을 받을 수 있습니다. 게다가, Deno 기술을 뽐내고 API를 직접 사용해 볼 수 있는 재미있는 방법이기도 합니다. 😎


기여하기 🤝

아이디어가 있으신가요? 버그를 발견하셨나요? 달의 위상 가격 예측 같은 기능을 추가하고 싶으신가요? 포크하고, 수정하고, 홍보하세요! 은하계에서 가장 멋진 MCP 서버를 만들어 봅시다. 🌌


라이센스 📜

MIT – 원하는 대로 하세요. 토큰이 망가지거나 떨어지더라도 저를 탓하지 마세요! 🌑📉


즐거운 암호화폐 사냥 되세요! 그리고 여러분의 가방은 항상 녹색이기를 바랍니다! 💚

ID: q9eclrlask