Cryptomcp

🚀 🪙 暗号通貨MCPサーバー

このサーバーは FastMCP を使用し、API 猪鼻 Crypto API からのリアルタイム暗号通貨データを提供します。

🚀 クイックスタート

以下の手順に従って、ローカルでサーバーをセットアップして実行します。

前提条件

• Python 3.10 以上
• git
• 仮想環境ツール（venv または uv など）
• API 猪鼻 からの API キー（Crypto API 専用）

インストールとセットアップ

1. リポジトリをクローンする：

git clone https://github.com/<your-username>/crypto-mcp-server.git # 実際のリポジトリ URL に置き換える
cd crypto-mcp-server

2. 仮想環境を作成してアクティブ化する：
   • venv（標準ライブラリ）を使用する場合：

python3 -m venv venv
source venv/bin/activate # Windows では `venv\Scripts\activate` を使用

- `uv`（インストールされている場合）を使用する場合：

uv venv venv
source venv/bin/activate

3. 依存関係をインストールする：
   • pip（venv と一緒に使用）を使用する場合：

pip install -e ".[dev]" # 開発環境をインストール
pip install -r requirements.txt # その他の依存関係をインストール

- `uv` を使用する場合：

uv add crypto-mcp-server

4. サーバーを実行する：

python -m fastmcp --config config.yaml

設定ファイル

config.yaml 設定ファイルを作成します。例：

api_key: your_api_key_here

✨ 主な機能

• シンボルの一覧表示： 利用可能なすべての暗号通貨シンボルのリストを取得します。
• 価格の取得： 特定のシンボルの現在の価格とタイムスタンプを取得します。
• MCP 互換性： FastMCP を使用して標準的な MCP 通信を行います。
• 非同期 API クライアント： httpx を使用して、効率的で非ブロッキングの API 呼び出しを行います。
• データ検証： pydantic を使用して、堅牢なデータ検証を行います。
• テスト済み： 単体テストと統合テスト（pytest を使用）が含まれています。

💻 使用例

基本的な使用法

暗号通貨の価格を照会するには、以下のコマンドを使用します。

python -m fastmcp crypto_price --symbol BTC,ETH,XRP --interval 24H,7D

高度な使用法

環境変数を使用して API キーを設定することもできます。

API_KEY=your_api_key_here python -m fastmcp crypto_price --symbol BTC,ETH,XRP

📚 ドキュメント

📈 データ可視化

このプロジェクトは基本的なデータ可視化機能を提供し、ユーザーが暗号通貨市場の傾向をよりよく理解できるようにします。

サンプルグラフ

• ビットコイン価格の折れ線グラフ：
• エーテリアム価格の比較グラフ：

🔄 データソース

このプロジェクトのデータは API 猪鼻 Crypto API から取得され、リアルタイムおよび履歴の暗号通貨データを提供します。

データ更新頻度

• リアルタイム価格更新：1 分ごと
• 履歴データ：時間、日、週、月ごとに更新

🛠️ 開発とテスト

開発環境のインストール

git clone https://github.com/your-username/crypto-mcp-server.git
cd crypto-mcp-server
pip install -e ".[dev]"

テストの実行

pytest tests/

🙏 コントリビューションガイド

コントリビューションを歓迎します！自由に問題を開いたり、プルリクエストを送信したりしてください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細については LICENSE ファイルを参照してください。

⚠️ 重要な注意事項

このサーバーを使用するには、API 猪鼻 からの API キーが必要です。

💡 使用上のヒント

環境変数を使用して API キーを設定することで、コマンドラインでの操作が簡単になります。