todoms-mcp
If you are the rightful owner of todoms-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
todoms-mcp は、Todo管理アプリケーション「todoms」用のModel Context Protocol（MCP）サーバーです。MCPを使用してユーザー認証とTodo管理の機能を提供します。
todoms-mcp
todoms-mcp は、Todo管理アプリケーション「todoms」用のModel Context Protocol（MCP）サーバーです。MCPを使用してユーザー認証とTodo管理の機能を提供します。
概要
このプロジェクトは、Model Context Protocol（MCP）を活用して、AI開発ツールからTodo管理アプリケーションの機能にアクセスするためのブリッジとして機能します。ユーザー登録、認証、およびTodoアイテムの作成、取得、更新、削除などの機能を提供します。
機能
-
ユーザー管理
- サインアップ - 新規ユーザー登録
- ログイン - 認証トークン取得
- ログアウト - セッション終了
- 現在のユーザー情報取得
-
Todo管理
- 全Todoの取得
- 特定のTodoの取得
- 単一または複数のTodoの作成
- Todoの更新
- Todoの削除
技術スタック
- TypeScript - 開発言語
- Node.js - 実行環境
- Model Context Protocol (MCP) SDK - AI開発ツールとの連携
- Zod - データバリデーション
- Fetch API - HTTPリクエスト
前提条件
- Node.js (v14以上推奨)
- npm または yarn
- todoms API サーバーが稼働していること
インストール
# リポジトリのクローン
git clone https://github.com/yourusername/todoms-mcp.git
cd todoms-mcp
# 依存関係のインストール
npm install
# または
yarn install
使用方法
ビルド
npm run build
# または
yarn build
起動
npm start
# または
yarn start
MCPサーバーが起動し、stdin/stdoutを通じて通信を行います。
MCP ツール一覧
このMCPサーバーは以下のツールを提供します：
-
signup - ユーザー登録
- パラメータ:
email,password
- パラメータ:
-
login - ログイン
- パラメータ:
email,password
- パラメータ:
-
logout - ログアウト
- パラメータ: なし
-
get_all_todos - 全Todoを取得
- パラメータ: なし
-
get_todo - 特定のTodoを取得
- パラメータ:
todoId
- パラメータ:
-
create_todos - 複数のTodoを作成
- パラメータ:
todos(Todoオブジェクトの配列)
- パラメータ:
-
update_todo - Todoを更新
- パラメータ:
todoId,todoData
- パラメータ:
-
delete_todo - Todoを削除
- パラメータ:
todoId
- パラメータ:
プロジェクト構造
todoms-mcp/
├── src/
│ ├── index.ts # MCPサーバーのエントリーポイント
│ ├── tool.ts # MCPツールの定義
│ └── lib/
│ ├── api-client.ts # TodomsのRESTful APIクライアント
│ ├── model.ts # データモデルとZodスキーマ
│ └── todoms-repository.ts # APIクライアントのラッパー
├── package.json
├── tsconfig.json
└── README.md
開発
API設定
APIのベースURLは src/lib/api-client.ts の API_BASE_URL 定数で定義されています。デフォルトは http://localhost:8080 です。必要に応じて変更してください。
新機能の追加
model.tsにデータモデルとバリデーションスキーマを追加api-client.tsにAPIエンドポイントへのメソッドを追加- 必要に応じて
todoms-repository.tsにリポジトリメソッドを追加 tool.tsに新しいツールを定義
ライセンス
ISC
