My MCP Server 3rt

🚀 MCP 暗号通貨プロトコル

MCP (Model Context Protocol) 暗号通貨プロトコルは、FastMCP を通じてモデルコンテキストプロトコルのサーバー側インターフェイスを実現する、効率的なアプリケーションプロトコルです。このプロトコルは、TimescaleDB 時系列データベースと CCXT 暗号通貨取引ライブラリの強力な機能を組み合わせ、暗号通貨市場データ、ニュース分析、AI 駆動の洞察を提供する統一プラットフォームを構築します。

🚀 クイックスタート

📦 インストール

クイックインストール

pip を使用して、以下のコマンドで一括インストールできます。

pip install mcp-crypto

サービスの起動

MCP 暗号通貨サーバーを起動するには、以下のコマンドを実行します。

python -m mcp.crypto serve --host localhost --port 8000

✨ 主な機能

コア機能

• 市場データ：リアルタイムおよび過去の市場データを取得でき、カスタムの期間でのクエリもサポートしています。
• ニュース分析：RSS フィードの集約と感情分析を通じて、暗号通貨関連のニュース洞察を提供します。
• AI 駆動の洞察：MCP プロトコルを利用して AI モデルを接続し、取引提案や市場予測を生成します。

リソースとツール

リソース

• symbols://list：サポートされているすべての暗号通貨シンボルを取得します。
• market_data://{symbol}：特定のシンボルのリアルタイム市場データを取得します。
• historical_data://{symbol}?timeframe={timeframe}&start={start}&end={end}：期間を指定して過去のデータをクエリします。
• news://recent：最新のニュース要約を取得します。
• news://{source}：ソースからニュースを取得します。
• news://by-coin/{symbol}：暗号通貨シンボルに関連するニュースを取得します。

ツール

• 市場分析ツール：市場トレンドを分析し、取引提案を生成します。
• ニュース感情分析：ニュースが市場に与える影響を評価し、洞察を提供します。
• 取引戦略生成器：データとモデルに基づいて取引戦略を生成します。

🔧 技術詳細

コアコンポーネント

1. TimescaleDB データベース統合

• 時系列データの保存：TimescaleDB の hypertables を利用して、過去の市場データを保存およびクエリします。
• 効率的なクエリ：期間、資産、複数の指標による複雑なクエリをサポートし、高い読み書き性能を備えています。

2. CCXT 暗号通貨取引ライブラリ

• 複数取引所のサポート：100 以上の主流暗号通貨取引所に接続し、リアルタイム市場データと過去のデータを取得します。
• 統一インターフェイス：標準 API を通じて、接続されたすべての取引所の市場情報、注文帳、取引データを取得します。

3. MCP プロトコルの実装

• モデルコンテキストプロトコル：FastMCP に基づいて実装され、AI モデルと暗号通貨データソースを接続するための統一インターフェイスを提供します。
• リソースとツール：
  • リソース：市場データ、資産リスト、ニュースデータなどを提供します。
  • ツール：市場分析ツール、ニュース感情分析ツール、取引戦略生成器を含みます。

4. uv パッケージマネージャー

• 依存関係の管理：uv は高性能の Python パッケージマネージャーで、プロジェクトの依存関係を迅速に追加および同期します。
• 効率的な管理：

# 新しい依存関係を追加
uv add package_name

# すべての依存関係を同期
uv pip sync

# 依存関係のロックファイルを生成
uv pip compile -o uv.lock

💻 使用例

基本的な使用法

サーバーサイド開発

カスタム MCP サーバーを作成する例を以下に示します。

from mcp.crypto.server import MCPServer

# 簡単な MCP サーバーを作成
server = MCPServer(host="localhost", port=8000)

# 新しいリソースを定義
@server.resource("example://test")
def get_example_resource():
    return {"message": "Hello, MCP!"}

# サーバーを起動
if __name__ == "__main__":
    server.start()

クライアントサイド使用

MCP クライアントを使用してリソースとツールにアクセスする例を以下に示します。

from mcp import Client

# ローカルサーバーに接続
client = Client("http://localhost:8000")

# 市場データをリクエスト
market_data_response = await client.query(
    inputs=["BTC/USD"],
    resources=["market_data:BTC/USD"]
)
print(market_data_response.outputs)

# ニュース分析ツールを使用
news_analysis_response = await client.query(
    inputs=["BTC/USD"],
    tools=["news_analysis"]
)
print(news_analysis_response.outputs)

高度な使用法

カスタムリソースの作成

新しいリソースを定義する例を以下に示します。

from mcp.crypto.server import MCPServer

# カスタムリソースを作成
class ExampleResource:
    def get(self, symbol):
        return f"Example data for {symbol}"

# リソースをサーバーに登録
server.add_resource("example://custom", ExampleResource())

ツールを使用した取引戦略の生成

ニュース分析ツールを使用して取引提案を生成する例を以下に示します。

from mcp.crypto.tools import NewsAnalyzer

# ニュース分析ツールを初期化
news_analyzer = NewsAnalyzer()

# ニュースを分析して戦略を生成
analysis = news_analyzer.analyze("latest BTC news")
print(analysis.strategy)

📚 ドキュメント

サーバーサイド開発ガイド

1. カスタムリソースの作成：新しいリソースクラスを定義し、get メソッドを実装してサーバーに登録します。
2. ツールの追加：新しいツールクラスを作成し、analyze メソッドを実装してサーバーに登録します。

クライアントサイド使用ガイド

1. サーバーへの接続：Client クラスを使用して MCP サーバーに接続します。
2. リソースとツールのリクエスト：query メソッドを呼び出して、必要なデータと分析結果を取得します。

入門サンプル

サンプルコード

from mcp import Client

# ローカルサーバーに接続
client = Client("http://localhost:8000")

# リアルタイム市場データをリクエスト
market_data_response = await client.query(
    inputs=["BTC/USD"],
    resources=["market_data:BTC/USD"]
)
print(market_data_response.outputs)

# ニュース分析ツールを使用して洞察を取得
news_insight = await client.query(
    inputs=["ETH/USD"],
    tools=["news_analysis"]
)
print(news_insight.outputs)

サンプルの実行

サーバーを起動するには、以下のコマンドを実行します。

python -m mcp.crypto serve --host localhost --port 8000

クライアントスクリプトを実行するには、以下のコマンドを実行します。

python client_script.py

拡張閲覧

• MCP プロトコルドキュメント：MCP プロトコルの仕組みとインターフェイス定義を詳しく理解することができます。
• TimescaleDB ドキュメント：TimescaleDB で時系列データを効率的に保存およびクエリする方法を学ぶことができます。
• CCXT ドキュメント：暗号通貨取引所の統合とデータ取得方法についてさらに詳しく調べることができます。

🤝 プロジェクトへの貢献

貢献ガイド

コミュニティからのコード貢献を歓迎します！詳細については、CONTRIBUTING.md を参照してください。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。内容は以下の通りです。

MIT License

Copyright (c) 2023 MCP-Crypto Authors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

🛠️ プロジェクトのメンテナンス

メンテナンスチーム

• コア開発者：
  • [Your Name] (Your GitHub)
  • [Other Developer Name] (GitHub)

連絡先

• メールリスト：project-discussion@mcp-crypto.org
• GitHub リポジトリ：https://github.com/mcp-crypto/mcp-crypto

🙏 謝辞

すべての貢献者とコミュニティメンバーに感謝します。皆さんの支援により、MCP 暗号通貨プロトコルがより良いものになっています。