Hula MCP

🚀 HuLa 即時通信アプリケーションの MCP サービス

HuLa 即時通信アプリケーションの MCP（Message Communication Protocol）サービスは、HTTP ベースのプロトコル実装で、即時通信アプリケーションにおけるメッセージ通信機能を提供します。このサービスは、RESTful API と Server-Sent Events (SSE) インターフェースを定義することで、メッセージの送信、受信、管理を実現しています。

✨ 主な機能

• 即時通信アプリケーションにおけるメッセージの送信、受信、管理機能を提供。
• RESTful API と Server-Sent Events (SSE) インターフェースを定義し、柔軟な通信を実現。

🔧 技術詳細

技術スタック

• TypeScript：バックエンド開発に使用。
• Express.js：Node.js ベースの Web アプリケーションフレームワーク。
• MCP SDK：MCP プロトコルの具体的な実装を提供。
• Zod：データ検証用のライブラリ。

📦 インストール

リポジトリのクローン

Git を使用してこのプロジェクトをクローンします。

git clone git@github.com:your-repository.git
cd huila-mcp

依存関係のインストール

プロジェクトに必要な依存パッケージをインストールします。

npm install
# または pnpm を使用する場合
pnpm install

サービスの起動

MCP サービスを起動します。

npm run start
# または pnpm を使用する場合
pnpm run start

デフォルトでは、サービスは http://localhost:3100 で実行されます。

📚 ドキュメント

プロジェクト構造

以下はプロジェクトのディレクトリ構造です。

src/
├── resources/                 # リソースモジュールのディレクトリ
│   ├── messages.ts           # メッセージリソースの実装
│   └── users.ts             # ユーザーリソースの実装
├── tools/                    # ツールモジュールのディレクトリ
│   └── index.ts             # ツールの登録エントリファイル
└── server.ts                 # サービスの初期化ファイル

API 説明

リソース（Resources）

メッセージリソース（Messages）

• メッセージの取得

  GET /messages
  

• メッセージの送信

  POST /messages
  

ユーザーリソース（Users）

• ユーザーリストの取得

  GET /users
  

ツール（Tools）

メッセージツール（Message Tool）

server.tool('message', (context) => {
    // ツールの実装
});

AI アシスタントへの統合

モバイル端末の統合

方法 1：CLI ツールを使用する

1. CLI をインストールします。

   npm install -g hula-mcp-cli
   

2. サービスを起動します。

   hula-mcp start
   

3. 統合を設定します。

   hula-mcp setup http://localhost:3100 --client mobile
   

方法 2：手動で統合する

1. サービスを起動します。
2. 設定ファイル config.json を作成します。

   {
     "name": "HuLa-Mobile",
     "version": "1.0.0",
     "description": "モバイルクライアントの MCP 設定",
     "baseUrl": "http://localhost:3100"
   }
   

サーバーサイドの統合

方法 1：CLI ツールを使用する

hula-mcp start
hula-mcp setup http://localhost:3100 --client server

開発に関する説明

新しいリソースの追加

src/resources ディレクトリにファイルを作成または編集し、server.resource() メソッドを使用してリソースを登録します。

新しいツールの追加

src/tools/index.ts ファイルで server.tool() メソッドを使用してツールを登録します。

🤝 貢献ガイド

1. このリポジトリを Fork します。
2. 機能ブランチを作成します。

   git checkout -b feature/your-feature
   

3. 変更をコミットします。

   git commit -m '新機能の追加'
   

4. ブランチをプッシュします。

   git push origin feature/your-feature
   

5. Pull Request を作成します。

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。