Intent MCP Server

🚀 意図 MCP サーバー

自然言語の意図を処理し、それを構造化された実行可能な形式に変換する Model Context Protocol (MCP) サーバーです。このサーバーは、意図の管理と処理を行う強力で信頼性の高い API を提供し、拡張性と信頼性に重点を置いています。

🚀 クイックスタート

このプロジェクトは、自然言語入力を構造化オブジェクトに変換し、実行可能なワークフローを生成する意図処理アーキテクチャを実装しています。保守性、型安全性、拡張性に配慮し、意図管理用のクリーンな API を提供します。

✨ 主な機能

• 🎯 意図処理：意図の作成、取得、処理
• 🔍 自然言語理解：ユーザーの原始的な意図を解析し理解
• 🧩 意図分解：意図を目標と制約を含む構造化オブジェクトに変換
• 💾 柔軟なストレージ：プラグイン可能なストレージシステムで、メモリ実装を内蔵
• 📝 型安全性：完全な TypeScript 実装で、包括的な型定義付き
• 🛡️ エラー処理：強力なエラー処理とログ記録システム
• 🧪 テスト：Jest を使用した包括的なテストスイート
• 📚 API ドキュメント：明確な API ドキュメントとサンプル

📦 インストール

前提条件

• Node.js (v18 以上)
• npm または yarn

インストール手順

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

git clone https://github.com/openpandacodes/intent-mcp-server.git
cd intent-mcp-server

2. 依存関係をインストールします：

npm install

3. .env ファイルを作成します：

touch .env

📚 ドキュメント

設定

以下のオプションは環境変数で設定できます：

• NODE_ENV：環境を設定（デフォルトは development）
• PORT：サーバーのポートを設定（デフォルトは 3000）
• LOG_LEVEL：ログレベルを設定（デフォルトは info）

使用方法

開発モード

npm run dev

本番モード

npm start

テスト

npm test

カバレッジテスト

npm run coverage

API エンドポイント

意図の作成

POST /intents

意図の取得

GET /intents/:id

ヘルスチェック

GET /health

アーキテクチャ

このサーバーは階層化アーキテクチャに従っています：

• コントローラー（Controller）：HTTP リクエストとレスポンスを処理
• サービス（Service）：ビジネスロジックとデータ操作を担当
• ストレージ（Storage）：データの永続化機能を提供

主要コンポーネント

• IntentController：意図関連のリクエストを処理
• IntentService：意図の作成と検索を管理
• IntentStore：意図データを保存

プロジェクト構造

intent-mcp-server/
├── src/
│   ├── controllers/
│   │   └── IntentController.ts
│   ├── services/
│   │   └── IntentService.ts
│   └── storage/
│       └── IntentStore.ts
├── .env
└── package.json

意図構造

interface Intent {
  id: string;
  name: string;
  description?: string;
  status: 'pending' | 'processing' | 'completed' | 'failed';
  metadata?: Record<string, any>;
}

エラー処理

• カスタムエラークラスを提供
• 問題を追跡するためのログ記録
• 適切な HTTP ステータスコードを返す

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

1. 機能ブランチを作成します：

git checkout -b feature/new-feature

2. コードをコミットする際は Conventional Commits 規約に従います。

3. 主要リポジトリに Pull Request を提出します。

4. 関連するドキュメントとテストケースを更新します。

📄 ライセンス

MIT License - 詳細は LICENSE ファイルを参照してください