ccfolia-mcp-workers
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ccfolia-mcp-workers田中太郎という30歳の探偵キャラクターを生成して"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ココフォリア MCP Workers
TRPGオンラインセッションツール「ココフォリア」用のMCP API (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 deployGitHub Actionsで自動デプロイ
# プッシュするだけで自動デプロイ
git push origin main
# → GitHub Actionsが自動でCloudflareにデプロイRelated MCP server: Remote MCP Server (Authless)
🤖 Claude Desktop 統合
自動セットアップ(推奨)
# Linux/macOS
./scripts/setup-claude-mcp.sh
# Windows PowerShell
.\scripts\setup-claude-mcp.ps1手動セットアップ
MCP依存関係をインストール:
npm install @modelcontextprotocol/sdkClaude Desktop設定ファイルを編集:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
設定内容:
{
"mcpServers": {
"ccfolia-mcp": {
"command": "node",
"args": [
"/path/to/ccfolia-mcp-workers/mcp-server.js"
],
"env": {
"WORKER_URL": "https://your-worker.workers.dev"
}
}
}
}Claude Desktop を再起動
Claude Desktop での使用方法
Claude Desktop で以下のように質問するだけで、TRPGツールが使用できます:
「田中太郎という30歳の探偵キャラクターを生成して」
「学校の怪奇現象シナリオ用にNPCを3体生成して」
「このセッションの進行状況を分析して」
「探索用のランダムイベントを生成して」
「戦闘ルールについて教えて」🎮 機能
キャラクター生成: TRPGキャラクターの自動生成
NPC一括生成: シナリオに応じたNPC群の生成
セッション分析: 進行状況の自動分析
ランダムイベント: 状況に応じたイベント生成
ルール支援: ルール説明とコマンド提案
📡 API エンドポイント
エンドポイント | メソッド | 説明 |
| GET | ヘルスチェック |
| POST | キャラクター生成 |
| POST | NPC一括生成 |
| POST | セッション分析 |
| POST | ランダムイベント生成 |
| 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対応済み
レート制限実装
入力値検証
エラーハンドリング
🤝 コントリビューション
このリポジトリをフォーク
機能ブランチを作成 (
git checkout -b feature/amazing-feature)変更をコミット (
git commit -m 'Add amazing feature')ブランチにプッシュ (
git push origin feature/amazing-feature)プルリクエストを作成
開発ガイドライン
TypeScriptを使用
ESLint/Prettierに従う
テストを追加
ドキュメントを更新
📄 ライセンス
MIT License - 詳細は LICENSE ファイルを参照
🙏 謝辞
ココフォリア - 素晴らしいTRPGツール
Cloudflare Workers - 高性能なサーバーレス環境
TRPGコミュニティの皆様
📞 サポート
Issues: GitHub Issues
Discussions: GitHub Discussions
Discord: TRPGコミュニティサーバー
🔄 更新履歴
v1.0.0 (2024-XX-XX)
初回リリース
基本的なキャラクター生成機能
NPC一括生成機能
セッション分析機能
今後の予定
AI モデル統合 (OpenAI/Claude)
より詳細な分析機能
カスタムルールシステム対応
リアルタイム通知機能
Web UI の提供
Happy Gaming! 🎲✨
このプロジェクトがあなたのTRPGセッションをより楽しくすることを願っています!
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
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/anker12345/ccfolia-mcp-workers'
If you have feedback or need assistance with the MCP directory API, please join our Discord server