mcp-todo-server

基本的なMCP（Model Context Protocol）サーバーで、タスクリスト（to-do list）を公開します。TypeScriptと公式SDK @modelcontextprotocol/sdk で実装されています。

課外課題1 — プログラミングIV — Model Context Protocol。

公開機能

Related MCP server: MCP Todo Server

プロジェクト構造

mcp-todo-server/
├── src/
│   └── server.ts       # Servidor MCP principal
├── tasks.json           # Almacenamiento de tareas (base de datos simple)
├── tsconfig.json        # Configuración de TypeScript
├── package.json
└── README.md

要件

• Node.js 18 以上

• npm

インストール

npm install

これにより依存関係がインストールされます: @modelcontextprotocol/sdk、zod（スキーマ検証）、開発依存関係として typescript、@types/node、tsx。

実行

開発モード（TypeScriptを直接実行し、コンパイルしません）:

npm run dev

本番モード（JavaScriptにコンパイルしてから実行します）:

npm run build
npm start

サーバーは stdio（標準入出力）で通信します。これは Claude Desktop やほとんどのローカルMCPクライアントが使用するトランスポートです。正常に起動すると、ターミナルに次のように表示されます:

Servidor MCP 'mcp-todo-server' corriendo por stdio...

このメッセージは意図的に stderr に出力されます。stdout を流れる JSON-RPC メッセージに干渉しないようにするためです。

グラフィカルクライアントなしで試す方法

公式の MCP Inspector を使用できます。これは、Resources、Tools、Prompts を手動で呼び出すためのWebインターフェースを開きます。

npx @modelcontextprotocol/inspector npx tsx src/server.ts

各機能の使用例

タスクリソースを読み取る → tasks.json の tasks 配列をJSON形式で返します。

Tool add_task の引数:

{ "name": "Repasar JSON-RPC", "description": "Leer la especificación 2.0", "priority": "media" }

Tool complete_task の引数:

{ "id": 1 }

Prompt daily_summary は引数を受け取りません。保留中のタスクと完了済みのタスクを優先度ごとにグループ化して、自動的に要約を作成します。

著者

Camila — Universidad Nacional de Costa Rica、プログラミングIV。