Zaifer-MCP

Instructions

Implementation Reference

• zaifer_mcp/tools/market.py:21-51 (handler)

  The primary MCP tool handler for 'get_ticker'. Decorated with @mcp.tool() for registration, it delegates to the Zaif API's market.get_ticker method to retrieve real-time ticker data for the specified currency pair.
  @mcp.tool() def get_ticker(currency_pair: SupportedPair) -> Ticker: """ 指定した通貨ペアのティッカー情報を取得します。 現在の市場価格統計を提供し、以下の用途で使用します： - 現在の市場価格と24時間の価格変動を確認したい場合 - 売買注文の価格設定の参考にしたい場合 - 市場の活発さ（取引量）を把握したい場合 使用例: - ビットコインの現在価格を確認したい場合 - 最適な注文価格を決定するため最良売買価格を確認したい場合 - 24時間の価格レンジを分析したい場合 Args: currency_pair: 通貨ペア（'btc_jpy': ビットコイン/円、'eth_jpy': イーサリアム/円、'xym_jpy': シンボル/円） Returns: Ticker: ティッカー情報 - last_price: 最終取引価格 - high_price: 24時間最高値 - low_price: 24時間最安値 - ask_price: 最良売り価格 - bid_price: 最良買い価格 - volume: 24時間取引量 Raises: ValueError: 通貨ペアが無効な場合や、APIエラーが発生した場合 """ return api.market.get_ticker(currency_pair)
• zaifer_mcp/models/market.py:154-209 (schema)

  Data class defining the output structure of the get_ticker tool, including fields for last price, high/low, bid/ask, and volume, with from_dict factory for API response parsing.
  @dataclass class Ticker: """ ティッカー情報を表すデータクラス。 Attributes: last_price: 最終取引価格 high_price: 最高値（24時間） low_price: 最安値（24時間） ask_price: 売り注文最安値 bid_price: 買い注文最高値 volume: 24時間取引量 """ last_price: Decimal high_price: Decimal low_price: Decimal ask_price: Decimal bid_price: Decimal volume: Decimal @classmethod def from_dict(cls, data: Dict[str, Any]) -> 'Ticker': """ APIレスポンスからTickerインスタンスを作成します。 Args: data: APIレスポンスの辞書 Returns: Tickerインスタンス """ return cls( last_price=Decimal(str(data['last'])), high_price=Decimal(str(data['high'])), low_price=Decimal(str(data['low'])), ask_price=Decimal(str(data['ask'])), bid_price=Decimal(str(data['bid'])), volume=Decimal(str(data['volume'])) ) def to_dict(self) -> Dict[str, Any]: """ TickerインスタンスをAPIレスポンス形式の辞書に変換します。 Returns: APIレスポンス形式の辞書 """ return { 'last': str(self.last_price), 'high': str(self.high_price), 'low': str(self.low_price), 'ask': str(self.ask_price), 'bid': str(self.bid_price), 'volume': str(self.volume) }
• zaifer_mcp/models/common.py:4-7 (schema)

  Literal type defining the valid input values for the currency_pair parameter: only 'btc_jpy', 'eth_jpy', 'xym_jpy' are supported.
  from typing import Literal # 対応する通貨ペアを明示的に制限 SupportedPair = Literal["btc_jpy", "eth_jpy", "xym_jpy"]
• zaifer_mcp/api/client.py:228-241 (helper)

  Helper method in MarketApi class that performs the actual HTTP GET request to Zaif's ticker endpoint and parses the response into a Ticker object.
  def get_ticker(self, currency_pair: str) -> Ticker: """ ティッカー情報を取得 Args: currency_pair: 通貨ペア（例: 'btc_jpy'） Returns: Tickerオブジェクト """ url = f"{self.base_url}/1/ticker/{currency_pair}" data = self.http.get(url) return Ticker.from_dict(data)
• zaifer_mcp/server.py:34-39 (registration)

  Import and invocation of register_market_tools during server initialization, which defines and registers the get_ticker tool (among others) to the FastMCP instance.
  from zaifer_mcp.tools.market import register_market_tools from zaifer_mcp.tools.account import register_account_tools from zaifer_mcp.tools.trade import register_trade_tools from zaifer_mcp.tools.chart import register_chart_tools register_market_tools(mcp, zaif_api)