Coin MCP Server 🚀💰

1# Coin MCP Server 🚀💰
2 
3Welcome to the **Coin MCP Server** – your one-stop shop for snagging the latest cryptocurrency prices faster than you can say "To the moon!" 🌙 Built with `FastMCP` and spiced up with `zod` for validation, this little server is here to fetch token prices from Bitget’s API like a trusty crypto butler. 🧑‍💼
4 
5[中文文档](README-cn.md) | English
6 
7---
8 
9## What Does It Do? 🤔
10 
11This project spins up a server that lets you query the current price of any cryptocurrency (paired with USDT) using Bitget’s slick API. Want to know how much your favorite token is worth right now? Just ask, and boom – the price is yours! 💸
12 
13- **Tool**: `getTokenPrice`
14- **Mission**: Fetch the latest price of a token (e.g., `BGB`, `BTC`, `ETH`).
15- **Superpower**: It’s fast, it’s simple, and it’s powered by `FastMCP`! ⚡
16 
17- **Tool**: `getAnnoucements`
18- **Mission**: get annoucements
19 
20- **Tool**: `getCoinInfo`
21- **Mission**: Get detailed information about a specified token.
22- **Superpower**: Provides detailed information such as token transferability, supported chain list, chain network status, etc.
23 
24---
25 
26## Features 🌟
27 
28- 🎯 **Dead-Simple API**: Pass a token symbol, get a price. No fuss, no muss.
29- 🛡️ **Zod Validation**: Parameters are checked tighter than a vault door.
30- 📡 **Bitget Integration**: Pulls live data straight from Bitget’s market ticker API.
31- 🧠 **Error Handling**: Catches hiccups like a pro and logs them for you to giggle at later.
32 
33---
34 
35## Getting Started 🏁
36 
37Ready to dive into the crypto price pool? Here’s how to get this baby running:
38 
39### Prerequisites
40- **Deno**: You’ll need Deno installed because we’re fancy and modern. Grab it [here](https://deno.land/).
41- **Bitget API Access**: No API key needed – we’re hitting the public endpoint like champs! But if you’ve got a custom `BGURL`, set it as an environment variable.
42 
43### Installation
441. Clone this repo like it’s hot:
45   ```bash
46   git clone https://github.com/pwh-pwh/coin-mcp-server.git
47   cd coin-mcp-server
48   ```
492. Install dependencies (Deno handles this automagically via imports!).
50 
51### Running the Server
52Fire it up with:
53```bash
54deno run --allow-net --allow-env --allow-read main.ts
55```
56 
57or
58```bash
59deno run --allow-net --allow-env --allow-read https://deno.land/x/coin_mcp_server/main.ts
60```
61 
62- `--allow-net`: Lets us talk to Bitget’s API.
63- `--allow-env`: Grabs your `BGURL` env variable if you’ve set one.
64 
65The server will start in `stdio` mode, ready to serve up prices like a crypto vending machine! 🍔
66 
673. Support installation-free, directly deploy to deno, fork this project, log in dash.deno.com, set the environment variable StartType=sse to use the domain name provided by deno to connect in sse mode
68 
69---
70 
71### Configuration
72 
73config.json
74```json
75{
76  "mcpServers": {
77    "coin-mcp": {
78      "command": "deno",
79      "args": [
80        "run",
81        "--allow-net",
82        "--allow-read",
83        "--allow-env",
84        "https://deno.land/x/coin_mcp_server/main.ts"
85      ]
86    }
87  }
88}
89```
90 
91## Usage Example 🎮
92 
93Here’s how you’d call `getTokenPrice`:
94```json
95{
96  "tool": "getTokenPrice",
97  "parameters": {
98    "token": "BGB"
99  }
100}
101```
102 
103**Response**:
104```
105"42.069"  // The latest BGB/USDT price (not a real price, just vibes!)
106```
107 
108If the token doesn’t exist or the API hiccups, it’ll throw an error with a cheeky log to remind you it tried its best. 😅
109 
110---
111 
112## Code Sneak Peek 👀
113 
114Here’s the magic behind the curtain:
115- **FastMCP**: Spins up the server with a cool name and version.
116- **Zod**: Keeps your `token` parameter in check.
117- **Bitget API**: Fetches ticker data from `https://api.bitget.com/api/v2/spot/market/tickers`.
118 
119The `getBitgetPrice` function is the MVP, grabbing that sweet `lastPr` (last price) from the response. Check the logs for price updates or error comedy gold! 😂
120 
121---
122 
123## Environment Variables 🌍
124 
125- `BGURL`: Custom Bitget API base URL (defaults to `https://api.bitget.com` if not set). Set it like:
126  ```bash
127  export BGURL="https://your-custom-bitget-url.com"
128  ```
129 
130---
131 
132## Troubleshooting 🛠️
133 
134- **“HTTP error! status: 404”**: Double-check your token symbol. `BGBUSDT` isn’t the same as `BGB`!
135- **“Network error”**: Make sure you’ve got internet and Deno’s `--allow-net` flag.
136- **Still stuck?**: Yell into the void (or open an issue). We’ll figure it out together! 🙌
137 
138---
139 
140## Why This Exists 🎉
141 
142Because who doesn’t want to know the price of their crypto stash in real-time? Whether you’re a trader, a HODLer, or just crypto-curious, this server’s got your back. Plus, it’s a fun way to flex some Deno skills and play with APIs. 😎
143 
144---
145 
146## Contributing 🤝
147 
148Got ideas? Found a bug? Want to add a feature like moon phase price predictions? Fork it, tweak it, PR it! Let’s make this the coolest MCP server in the galaxy. 🌌
149 
150---
151 
152## License 📜
153 
154MIT – Do whatever you want with it, just don’t blame me if your token moons or dumps! 🌑📉
155 
156---
157 
158Happy crypto hunting, and may your bags always be green! 💚
159