Skip to main content
Glama

ココフォリア MCP Workers

TRPGオンラインセッションツール「ココフォリア」用のMCP API (Cloudflare Workers版)

Deploy to Cloudflare Workers

🚀 クイックスタート

ワンライナーデプロイ

curl -sSL https://raw.githubusercontent.com/USERNAME/ccfolia-mcp-workers/main/scripts/deploy.sh | bash

手動デプロイ

git clone https://github.com/USERNAME/ccfolia-mcp-workers.git
cd ccfolia-mcp-workers
npm install
npm run deploy

GitHub Actionsで自動デプロイ

# プッシュするだけで自動デプロイ
git push origin main
# → GitHub Actionsが自動でCloudflareにデプロイ

Related MCP server: CivNode MCP Server

🤖 Claude Desktop 統合

自動セットアップ(推奨)

# Linux/macOS
./scripts/setup-claude-mcp.sh

# Windows PowerShell
.\scripts\setup-claude-mcp.ps1

手動セットアップ

  1. MCP依存関係をインストール:

npm install @modelcontextprotocol/sdk
  1. Claude Desktop設定ファイルを編集:

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Linux: ~/.config/Claude/claude_desktop_config.json

  2. 設定内容:

{
  "mcpServers": {
    "ccfolia-mcp": {
      "command": "node",
      "args": [
        "/path/to/ccfolia-mcp-workers/mcp-server.js"
      ],
      "env": {
        "WORKER_URL": "https://your-worker.workers.dev"
      }
    }
  }
}
  1. Claude Desktop を再起動

Claude Desktop での使用方法

Claude Desktop で以下のように質問するだけで、TRPGツールが使用できます:

「田中太郎という30歳の探偵キャラクターを生成して」
「学校の怪奇現象シナリオ用にNPCを3体生成して」
「このセッションの進行状況を分析して」
「探索用のランダムイベントを生成して」
「戦闘ルールについて教えて」

🎮 機能

  • キャラクター生成: TRPGキャラクターの自動生成

  • NPC一括生成: シナリオに応じたNPC群の生成

  • セッション分析: 進行状況の自動分析

  • ランダムイベント: 状況に応じたイベント生成

  • ルール支援: ルール説明とコマンド提案

📡 API エンドポイント

エンドポイント

メソッド

説明

/health

GET

ヘルスチェック

/generate_character

POST

キャラクター生成

/generate_npc_batch

POST

NPC一括生成

/analyze_session

POST

セッション分析

/generate_random_event

POST

ランダムイベント生成

/get_rule_help

POST

ルール支援

🎯 ココフォリア設定

カスタムスクリプトで以下を設定:

const MCP_SERVER_URL = "https://your-worker.workers.dev";

// チャットコマンドとして使用
async function mcpCommand(command, ...args) {
  try {
    const response = await fetch(`${MCP_SERVER_URL}/${command}`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ params: args })
    });
    const data = await response.json();
    return data.success ? data.data : data.error;
  } catch (error) {
    return `エラー: ${error.message}`;
  }
}

// 使用例
// /mcp character 田中太郎 30 探偵
// /mcp npc "学校の怪奇現象" 3
// /mcp analyze

💡 使用例

キャラクター生成

curl -X POST https://your-worker.workers.dev/generate_character \
  -H "Content-Type: application/json" \
  -d '{
    "name": "田中太郎",
    "age": 30,
    "profession": "探偵",
    "background": "元警察官"
  }'

NPC一括生成

curl -X POST https://your-worker.workers.dev/generate_npc_batch \
  -H "Content-Type: application/json" \
  -d '{
    "scenario": "学校の怪奇現象",
    "count": 3,
    "difficulty": "normal"
  }'

セッション分析

curl -X POST https://your-worker.workers.dev/analyze_session \
  -H "Content-Type: application/json" \
  -d '{
    "chatLogs": [...],
    "playerActions": [...],
    "sessionTime": 3600000
  }'

🛠️ 開発

環境構築

git clone https://github.com/USERNAME/ccfolia-mcp-workers.git
cd ccfolia-mcp-workers
./scripts/setup.sh

開発サーバー起動

npm run dev

テスト実行

# APIテスト
npm test

# 詳細テスト
./scripts/test-api.sh

# パフォーマンステスト
./scripts/test-api.sh http://localhost:8787 --performance

デプロイ

# Cloudflareログイン
wrangler auth login

# デプロイ
npm run deploy

# ログ確認
npm run tail

📁 プロジェクト構成

ccfolia-mcp-workers/
├── 📁 .github/workflows/    # GitHub Actions設定
├── 📁 src/                  # ソースコード
│   ├── 📄 index.ts          # メインAPIコード
│   ├── 📄 character-generator.ts  # キャラ生成ロジック
│   ├── 📄 npc-generator.ts  # NPC生成ロジック
│   └── 📄 session-analyzer.ts    # セッション分析
├── 📁 scripts/              # ユーティリティスクリプト
│   ├── 📄 deploy.sh         # デプロイスクリプト
│   ├── 📄 setup.sh          # 環境セットアップ
│   └── 📄 test-api.sh       # APIテストスクリプト
├── 📄 wrangler.toml         # Cloudflare設定
├── 📄 package.json          # 依存関係
├── 📄 tsconfig.json         # TypeScript設定
└── 📄 README.md             # このファイル

🔧 設定

環境変数

  • ENVIRONMENT: 実行環境 (development/staging/production)

  • CLOUDFLARE_API_TOKEN: Cloudflare APIトークン

  • CLOUDFLARE_ACCOUNT_ID: Cloudflare アカウントID

wrangler.toml

name = "ccfolia-mcp-api"
main = "src/index.ts"
compatibility_date = "2024-01-01"

[vars]
ENVIRONMENT = "production"

🎲 対応シナリオ

事前定義シナリオ

  • 学校の怪奇現象: 学園ホラー系のNPC・イベント生成

  • 村の失踪事件: 田舎ミステリー系

  • 古い屋敷の謎: クラシックホラー系

  • 都市の地下組織: 現代サスペンス系

  • 遺跡探索: 冒険・ファンタジー系

カスタムシナリオ

独自のシナリオにも対応。汎用的なNPC・イベント生成機能を使用。

📊 セッション分析機能

分析項目

  • プレイヤーエンゲージメント: 参加度・発言バランス

  • ストーリー進行: フェーズ検出・進行速度

  • ゲームプレイメトリクス: ダイス使用・成功率

  • 改善提案: データに基づく具体的なアドバイス

出力例

【セッション分析レポート】
セッション時間: 2時間30分
参加プレイヤー: 4名
全体エンゲージメント: 高
現在フェーズ: 調査段階

【改善提案】
・田中太郎プレイヤーの参加を促してください
・そろそろクライマックスへの展開を検討してください

🚀 パフォーマンス

  • レスポンス時間: 平均 < 200ms

  • 可用性: 99.9%+ (Cloudflare Workers)

  • 同時接続: 無制限

  • データ転送: 無料枠内で十分

🔐 セキュリティ

  • CORS対応済み

  • レート制限実装

  • 入力値検証

  • エラーハンドリング

🤝 コントリビューション

  1. このリポジトリをフォーク

  2. 機能ブランチを作成 (git checkout -b feature/amazing-feature)

  3. 変更をコミット (git commit -m 'Add amazing feature')

  4. ブランチにプッシュ (git push origin feature/amazing-feature)

  5. プルリクエストを作成

開発ガイドライン

  • TypeScriptを使用

  • ESLint/Prettierに従う

  • テストを追加

  • ドキュメントを更新

📄 ライセンス

MIT License - 詳細は LICENSE ファイルを参照

🙏 謝辞

📞 サポート

🔄 更新履歴

v1.0.0 (2024-XX-XX)

  • 初回リリース

  • 基本的なキャラクター生成機能

  • NPC一括生成機能

  • セッション分析機能

今後の予定

  • AI モデル統合 (OpenAI/Claude)

  • より詳細な分析機能

  • カスタムルールシステム対応

  • リアルタイム通知機能

  • Web UI の提供


Happy Gaming! 🎲✨

このプロジェクトがあなたのTRPGセッションをより楽しくすることを願っています!

A
license - permissive license
Not graded
quality - not tested
C
maintenance

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    A
    quality
    D
    maintenance
    An MCP server that enables text-to-speech generation and phonetic kana conversion using VOICEROID2 via voiceroid_daemon. It supports customizable voice parameters and provides cross-platform audio playback for synthesized speech.
    3
  • A
    license
    Not graded
    quality
    B
    maintenance
    MCP server for creating, managing, and interacting with AI-powered NPCs with persistent memory, supporting dialogue, game events, and persona generation for coding agents.
    57
    1
    Inno Setup

View all related MCP servers

Related MCP Connectors

  • MCP server for AI dialogue using various LLM models via AceDataCloud

  • An MCP server that integrates with Discord to provide AI-powered features.

  • Official remote MCP server for Archivist AI TTRPG campaign memory: characters, sessions, and more.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/yamaU390/ccfolia-mcp-api'

If you have feedback or need assistance with the MCP directory API, please join our Discord server