English Français العربية

io.github.wesseltl/price-data-mcp

السجل الرسمي المالية والمدفوعات

Live market prices and candles for AI agents (200+ coins). Data only, no trading advice.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package hyperliquid-price-mcp
Claude Code 
claude mcp add price-data-mcp -- uvx hyperliquid-price-mcp==0.1.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "price-data-mcp": {
            "command": "uvx",
            "args": [
                "hyperliquid-price-mcp==0.1.3"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. price-data-mcp
  2. What your agent can do with it
  3. Quickstart
  4. The tools
  5. Also usable from plain Python
  6. How it works
  7. Tests
  8. Scope
  9. License

price-data-mcp

Give your AI agent live market prices. An MCP server that lets an agent look up the current price, the full symbol list, and recent price history for 200+ coins.

An LLM's knowledge is frozen at training time, so it can't answer "what's BTC trading at right now?". This closes that gap. It returns market data only. It never gives a trading signal or predicts direction.

What your agent can do with it

You: What's Bitcoin trading at, and how has it moved over the last few hours?

Agent (calls get_price("BTC") and get_candles("BTC", "1h", 6)): Bitcoin is at $65,047. Over the last 6 hours it's held between $65,020 and $65,132 on rising volume.

The agent fetches real numbers instead of guessing from stale training data.

Quickstart

pip install "hyperliquid-price-mcp[mcp]"

Add it to your MCP client (e.g. Claude Desktop's config):

{
  "mcpServers": {
    "market-prices": { "command": "hyperliquid-price-mcp" }
  }
}

Restart your client. The agent now has four tools.

The tools

ToolReturns
get_price("BTC"){"symbol": "BTC", "price": 65047.5, "as_of": 1786204330859}
get_prices(["BTC","ETH"])current price for each, missing ones flagged
list_symbols()every symbol it can price (200+)
get_candles("BTC","1h",100)recent OHLCV history (1m … 1d)

Example candle:

{"open_ms": 1786201200000, "open": 65104.0, "high": 65132.0,
 "low": 65020.0, "close": 65047.0, "volume": 409.43, "trades": 7014}

Also usable from plain Python

from price_data_mcp import prices

prices.get_price("BTC")                # {'symbol': 'BTC', 'price': 65047.5, 'as_of': ...}
prices.get_candles("ETH", "1h", 24)    # last 24 hourly candles
prices.list_symbols()                  # ['AAVE', 'ADA', 'APE', ...]

How it works

Prices come from the public Hyperliquid info API. The core fetching module (price_data_mcp/prices.py) uses the Python standard library only (no dependencies), so it's small and easy to audit. The mcp extra is only needed to run the server.

Tests

python -m unittest discover -s tests     # network is mocked, runs fully offline

Scope

A market-data source for agents. It reports prices and history. It does not give trading signals, predict where the price is going, or place orders.

License

MIT

الأسئلة الشائعة

ما هو io.github.wesseltl/price-data-mcp؟

Live market prices and candles for AI agents (200+ coins). Data only, no trading advice.

كيف أثبّت io.github.wesseltl/price-data-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add price-data-mcp -- uvx hyperliquid-price-mcp==0.1.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.wesseltl/price-data-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.wesseltl/price-data-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.wesseltl/price-data-mcp؟

ينشره wesseltl. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.