ccfolia-mcp-api
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-api田中太郎という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: OpenWebGAL Assistant
🤖 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
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
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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