Coin MCP Server

🚀 Coin MCP Server 💰

Coin MCP Server is your one-stop real-time cryptocurrency price query center, providing responses faster than you can say "To the moon!" It is built on FastMCP and validated by zod, quickly fetching the latest token prices from Bitget's API, serving you like a reliable cryptocurrency butler.

English Document | Chinese

🚀 Quick Start

Coin MCP Server allows you to query the latest prices of any cryptocurrency paired with USDT using Bitget's efficient API. Just ask, and you'll get the price instantly!

Installation

1. Clone the repository to your local machine:

   git clone https://github.com/your-repository.git
   cd coin-mcp-server
   

2. Install the dependencies:

   npm install
   

Start the Server

node index.js

Example Requests

• Get the price of Bitcoin:

  curl http://localhost:3000/api/getTokenPrice/BTC
  

• Get detailed information about Ethereum:

  curl http://localhost:3000/api/getCoinInfo/ETH
  

For more examples, refer to the documentation.

✨ Features

• 🎯 Minimalist API: Pass a token symbol and get the price. No more words needed!
• 🛡️ Zod Validation: Parameter checking is as strict as a vault door.
• 📡 Bitget Integration: Get information directly from Bitget's real-time data source.
• ⚡ Fast Response: Millisecond-level latency ensures you get the latest price updates.

📦 Installation

1. Clone this repository to your local machine:

   git clone https://github.com/your-repository.git
   cd coin-mcp-server
   

2. Install the dependencies:

   npm install
   

💻 Usage Examples

Basic Usage

To get the price of a token, you can use the following command:

curl http://localhost:3000/api/getTokenPrice/BTC

Advanced Usage

To get detailed information about a token, you can use the following command:

curl http://localhost:3000/api/getCoinInfo/ETH

📚 Documentation

Function Overview

This project starts a server that allows you to query the latest price of any cryptocurrency (paired with USDT) using Bitget's efficient API.

• Tool: getTokenPrice

• Mission: Get the latest price of a specified token (e.g., BGB, BTC, ETH).

• Superpower: Fast, simple, and powered by FastMCP!⚡

• Tool: getAnnoucements

• Mission: Get announcement information.

• Tool: getCoinInfo

• Mission: Get detailed information about a specified token.

• Superpower: Provide detailed information about token transferability, supported chain lists, chain network status, etc.

Configuration

Environment Variables

• BGURL: Customize the Bitget API base URL (default is https://api.bitget.com).

  export BGURL="https://your-custom-bitget-url.com"
  

For more configuration information, refer to the documentation.

Troubleshooting

• "HTTP Error! Status: 404": Check if the token symbol is correct. BGBUSDT is different from BGB!
• "Network Error": Ensure you are connected to the internet and use Deno's --allow-net flag when starting.
• Still having problems?: Welcome to submit an issue, and we'll solve it together!

🔧 Technical Details

This server is built on FastMCP and uses zod for validation. It fetches the latest token prices from Bitget's API.

📄 License

This project is licensed under the MIT license. You can use it freely, but please bear any cryptocurrency fluctuation risks by yourself!🌙📉

Why This Project Was Created

This project aims to make cryptocurrency price queries more convenient. Whether you are a trader, long-term holder, or cryptocurrency enthusiast, this server can meet your needs. Additionally, it's a great opportunity to showcase the use of Deno and APIs!😎

Contribution

Have ideas? Found a bug? Want to add new features (such as moon phase price prediction)? Welcome to contribute, and let's build the coolest MCP server together!

May your coin wallet always be profitable, and wish you all the best in the cryptocurrency world!💚