To Do MCP Server

🚀 MCP サーバーで構築された Todo アプリ

このアプリケーションは、自然言語処理（Google Gemini API を使用）、MongoDB を用いた永続的なデータストレージ、リアルタイム更新に特化した MCP プロトコル（Server-Sent Events を利用）を統合し、Express.js 上にモジュール化された MVC アーキテクチャで構築されたシンプルな Todo アプリです。

✨ 主な機能

• 自然言語でのタスク追加（例：“Add a task to buy milk”）
• 全てのタスクの一覧表示（完了済みタスクを含むことも可能）
• MongoDB の ID を使ってタスクを完了済みにマーク
• MongoDB の ID を使ってタスクを削除
• Server-Sent Events (SSE) と MCP プロトコルを通じたリアルタイム更新の受信

📦 インストール

前提条件

• Node.js（v18 以上）
• MongoDB Atlas クラスター（認証情報が必要）
• Google Gemini API Key（Google AI Studio から取得）

インストール手順

1. リポジトリをクローン

   git clone https://github.com/theatulanand/to-do-mcp-server.git
   cd todo-mcp-single
   

2. 依存関係をインストール

   npm install
   

3. 環境変数を設定

   ルートディレクトリに .env ファイルを作成します。

   PORT=3000
   MONGO_URI=URI
   GEMINI_API_KEY=
   

💻 使用例

基本的な使用法

アプリケーションを起動するには、以下のコマンドを実行します。

npm start

以下のような出力が表示されれば成功です。

接続到 MongoDB（通过 Mongoose）
サーバーが http://localhost:3000 で起動しました

サーバーを停止するには、Ctrl + C を押します。

高度な使用法

/api/command に JSON 形式のリクエストを送信することで、タスクを操作できます。

{ "command": "Add a task to buy milk" }

サンプルコマンド

• タスクの追加

  curl -X POST http://localhost:3000/api/command -H "Content-Type: application/json" -d '{"command": "Add a task to buy milk"}'
  

• タスクの一覧表示

  curl -X POST http://localhost:3000/api/command -H "Content-Type: application/json" -d '{"command": "List my todos"}'
  

• タスクの完了マーク

  curl -X POST http://localhost:3000/api/command -H "Content-Type: application/json" -d '{"command": "Complete todo with ID some_mongodb_id"}'
  

• タスクの削除

  curl -X POST http://localhost:3000/api/command -H "Content-Type: application/json" -d '{"command": "Delete todo with ID some_mongodb_id"}'
  

• 完了済みタスクを含む一覧表示

  curl -X POST http://localhost:3000/api/command -H "Content-Type: application/json" -d '{"command": "List my todos including completed"}'
  

📚 ドキュメント

技術スタック

プロジェクト構造

todo-mcp-single/
├── models/           # Mongoose モデル
│   └── Todo.js
├── controllers/      # ビジネスロジック
│   └── todoController.js
├── routes/           # API ルート
│   └── todoRoutes.js
├── utils/            # ユーティリティ関数（例：Gemini とのやり取り）
└── index.js          # アプリケーションのエントリーポイント

リアルタイム更新（SSE）

/sse に接続することで、リアルタイム更新を受信できます。（MCP 互換クライアントが必要）

🔧 技術詳細

このアプリケーションは、Express.js をベースにした MVC アーキテクチャで構築されています。Mongoose を使って MongoDB とのやり取りを行い、Google Gemini API で自然言語コマンドを解析します。また、MCP プロトコルと Server-Sent Events を利用してリアルタイム更新を実現しています。

📄 注意事項

⚠️ 重要提示

MongoDB の接続文字列 (MONGO_URI) と Google Gemini API Key が正しく設定されていることを確認してください。大量のデータや高い並行リクエストを扱う場合は、適切なパフォーマンス最適化と負荷分散の設定を行うことをおすすめします。