https://claude.ai/chat/4dea4e6a-4f62-44b0-8a96-f87167a17fef https://claude.ai/public/artifacts/8f2db72a-f062-4d0c-b64c-e7f4018910d6

cloudflared tunnel --url http://localhost:3001

メールアドレス: test@example.com
パスワード: password123

PocketBase タスク MCP サーバー

PocketBase と統合してタスクやプロジェクトを管理する Model Context Protocol (MCP) サーバーです。このサーバーを使用すると、AI モデル（Claude など）がタスクの作成、ステータスフィルター付きのタスク一覧表示、プロジェクトの閲覧を行えるようになります。

HTTP で動作中 - ローカルでのテストが容易で、デプロイの準備も万端です！

機能

HTTP トランスポート: シンプルな URL ベースのアクセス、複雑な設定は不要
ツールチェーン: 最初に ID を取得することで、タスクをプロジェクトに自動的にリンク
プロジェクト管理: projects コレクションからすべてのプロジェクトを一覧表示
タスク管理: 必須のプロジェクト関係を持つ task コレクションにタスクを作成
ステータスフィルタリング: タスクを一覧表示し、「保留中（Pending）」または「完了（Completed）」ステータスでフィルタリング
環境変数駆動: PocketBase 認証用に .env ファイルで安全に管理
簡単なテスト: シンプルなヘルスチェックエンドポイントと MCP Inspector のサポート

⚡ クイックスタート

# 1. Install dependencies
npm install

# 2. Create .env file
echo "PB_AUTH_TOKEN=your_super_admin_token_here" > .env

# 3. Build the project
npm run build

# 4. Start the server
node dist/index.js

サーバーが http://localhost:3000 で起動しました！

テスト方法: ブラウザで http://localhost:3000/health を開いてください。

🚀 はじめに

1. 前提条件

Node.js (v18以上)
ローカルで http://127.0.0.1:8090 にて実行中の PocketBase
PocketBase スーパー管理者トークン

2. インストール

npm install

3. 設定

プロジェクトのルートに .env ファイルを作成します：

PB_AUTH_TOKEN=your_super_admin_token_here

🛠️ 開発とデバッグ

プロジェクトのビルド

TypeScript コードを JavaScript にコンパイルします：

npm run build

HTTP サーバーの起動

サーバーをローカルで実行します：

node dist/index.js

サーバーは http://localhost:3000（または .env ファイルで指定したポート）で起動します。

以下のような出力が表示されるはずです：

MCP server running on http://localhost:3000
Health check: http://localhost:3000/health
MCP endpoint: http://localhost:3000/mcp

サーバーのテスト

ブラウザでヘルスチェックエンドポイントにアクセスします：

http://localhost:3000/health

以下のように表示されるはずです：

{"status":"ok","message":"PMS MCP Server is running"}

オプションのポート設定

ポートを変更するには .env ファイルに追加します：

PORT=3000
PB_AUTH_TOKEN=your_super_admin_token_here

📖 利用可能なツール

list_projects: すべてのプロジェクトとその ID を取得します。
create_task: 新しいタスクを作成します（task_title、eta、status、project_id が必要）。
list_tasks: オプションのステータスフィルタリングを使用してすべてのタスクを一覧表示します。

🧪 ツールのテスト

MCP Inspector を使用するか、http://localhost:3000/mcp の HTTP エンドポイント経由で接続して、MCP サーバーをテストできます。

MCP Inspector の使用

npx @modelcontextprotocol/inspector

次に、http://localhost:3000/mcp に接続します。

🌐 なぜ Stdio ではなく HTTP なのか？

利点:

設定ファイル不要: claude_desktop_config.json などの複雑な設定を編集する必要がありません
簡単なテスト: ブラウザや Postman などのツールを使用して簡単に URL にアクセス可能
リモート対応: サーバーにデプロイしてどこからでもアクセス可能
マルチクライアント: 複数のアプリケーションが同時に接続可能
デバッグの向上: 標準的な HTTP ツールでリクエストとレスポンスを簡単に監視可能

MCP クライアントからの接続:

MCP 対応クライアントを使用する場合、以下に接続してください：

http://localhost:3000/mcp

📝 依存関係

@modelcontextprotocol/sdk: MCP のコア機能
pocketbase: PocketBase JS SDK
express: HTTP サーバーフレームワーク
cors: Cross-Origin Resource Sharing ミドルウェア
zod: スキーマバリデーション
dotenv: 環境変数管理

PocketBase Task MCP Server