Poop Mcp Server

Poop MCP Server

Poop MCP Server は、AI ツール向けの MCP（Model Control Protocol）サーバーを提供します。このサーバーにより、AI モデルは標準化されたプロトコルを通じて外部サービスと連携できます。

機能

• 3D シーンコマンドサービス：3D 環境で移動コマンドを処理します
• 暗号資産価格サービス：CoinGecko API を使用して暗号資産のリアルタイム価格を取得します
• Spring AI との統合：AI モデルとシームレスに統合するため、Spring AI のツールフレームワークを使用して構築されています
• Docker のサポート：Docker で簡単にデプロイできます

前提条件

• Java 17 以降
• Maven 3.6 以降
• Docker（任意。コンテナ化したデプロイに使用）
• CoinGecko API キー（暗号資産価格サービスに使用）

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

リポジトリのクローン

git clone https://github.com/AlienMCP/poop-mcp-server.git
cd poop-mcp-server

環境変数

プロジェクトのルートに .env ファイルを作成し、次の変数を設定します。

COINGECKO_API_KEY=your_api_key_here

アプリケーションのビルド

mvn clean package -DskipTests

使用方法

ローカルでの実行

java -jar target/poop-mcp-server-0.0.1-SNAPSHOT.jar

サーバーはデフォルトでポート 8888 で起動します。

プロファイル

アプリケーションは 3 つのプロファイルをサポートしています。

• dev（デフォルト）：開発環境
• test：テスト環境
• prod：本番環境

特定のプロファイルを指定して実行するには、次のコマンドを実行します。

java -jar target/poop-mcp-server-0.0.1-SNAPSHOT.jar --spring.profiles.active=prod

設定

アプリケーションプロパティ

メインの設定は application.yaml にあります。

spring:
  ai:
    mcp:
      server:
        name: poop-mcp-server
        version: 0.0.1
  profiles:
    active: '@profile.name@'
server:
  port: 8888

環境別の設定は次のファイルにあります。

• application-dev.yaml
• application-test.yaml
• application-prod.yaml

Docker によるデプロイ

Docker イメージのビルド

mvn clean package -DskipTests
docker build -t poop-mcp-server:latest .

Docker コンテナの実行

docker run -p 8888:8888 -e COINGECKO_API_KEY=your_api_key_here poop-mcp-server:latest

API ドキュメント

3D シーンコマンドサービス

3D シーンコマンドサービスは、3D 環境で移動コマンドを処理する機能を提供します。

移動コマンドの処理

processMoveCommand(command, target, distance)

• command：コマンドの種類（「move」のみ対応しています）
• target：方向（「front」、「back」、「left」、「right」）
• distance：移動距離（正の数）

コマンドの詳細またはエラーメッセージを含む JSON 文字列を返します。

暗号資産価格サービス

暗号資産価格サービスは、暗号資産のリアルタイム価格を取得する機能を提供します。

暗号資産価格の取得

fetchCryptoPrice(coin)

• coin：暗号資産の正式な名称（例：「bitcoin」、「ethereum」）

暗号資産の価格の詳細またはエラーメッセージを含む JSON 文字列を返します。

Spring AI との統合

このサーバーは、Spring AI のツールフレームワークと連携するように設計されています。サービスには @ToolServer、メソッドには @Tool アノテーションを付けることで、AI モデルがツールとして利用できるようになります。