Statistics MCP

🚀 神岛数据统计 MCP サーバー

このサーバーは、Model Context Protocol (MCP) をベースに構築されており、神島プラットフォームのユーザーデータ、マップ情報、統計データへのアクセスを提供します。

✨ 主な機能

• 公開 API：認証なしでアクセスできる基本データ（ユーザープロフィール、マップ詳細、コメントリスト）
• 認証 API：Token が必要な高度なデータ（ユーザーコメント、各種統計データ）
• マップ分析：包括的なマッププレイヤーデータ、残留率、行動分析など
• 型安全：完全な TypeScript 型定義により、コードの提案とエラーチェックが可能
• モジュール化設計：明確なコード構造で、保守と拡張が容易
• 標準インターフェース：MCP プロトコルに基づき、標準化されたツールインターフェースを提供
• 統合容易：ブラウザ、CLI などの多プラットフォームクライアントへの統合をサポート

📦 利用可能なツール

公開 API（認証不要）

認証が必要な API（Token が必要）

💻 使用例

公開 API の例

// ユーザープロフィールを取得
const userProfile = await getUserProfile(userId);

認証が必要な API の例

// マップの統計データを取得
const mapStats = await getMapStats(mapId, 'daily');

📚 プロジェクト構造

├── index.ts                # メインエントリーファイル
├── src/                    # ソースコードディレクトリ
│   ├── types/              # 型定義
│   │   └── index.ts        # 共有型定義
│   ├── utils/              # ユーティリティ関数
│   │   └── api.ts          # API リクエストツール
│   └── tools/              # MCP ツールの実装
│       ├── publicTools.ts  # 公開 API ツール
│       └── authTools.ts    # 認証が必要な API ツール
├── package.json            # プロジェクト設定と依存関係
├── tsconfig.json           # TypeScript 設定
└── README.md               # プロジェクトドキュメント

新しい API エンドポイントの追加方法

新しい API エンドポイントを追加するには、以下の手順に従ってください。

1. src/types/index.ts で必要に応じて新しい型定義を追加します。
2. 公開 API の場合は、src/tools/publicTools.ts で新しいツール定義を追加します。
3. 認証が必要な API の場合は、src/tools/authTools.ts で新しいツール定義を追加します。

🔧 技術スタック

• TypeScript
• モデルコンテキストプロトコル (MCP)
• Zod (型検証)
• Axios (HTTP リクエスト)

📄 ライセンス

MIT