MCP Server Template V4w

🚀 MCP サーバーテンプレート

このテンプレートは、AI ツールを構築するための Bun ランタイム専用の quiz 焦点型 MCP サーバー起動キットです。

🚀 クイックスタート

この MCP サーバーテンプレートを使用する前に、必要な環境を準備する必要があります。

✨ 主な機能

• quiz に特化した焦点型 MCP サーバーの実装
• 複数のカテゴリと難易度レベルを持つクイズツール
• MCP 統合テスト付きの Jest テスト設定
• 包括的なテストカバレッジ

📦 インストール

# リポジトリをクローン
git clone https://github.com/username/quiz-mcp-template.git
cd quiz-mcp-template

# 依存関係をインストール
bun install

📚 ドキュメント

Claude デスクトップ設定

{
  "quiz": {
    "command": "<your path>/.bun/bin/bun",
    "args": ["run", "<your path>/bun-mcp-template/src/index.ts"]
  }
}

使用方法

サーバーの起動

# サーバーを起動
bun start

# 開発モード（自動再起動付き）
bun dev

テスト

# すべてのテストを実行
bun test

MCP ツール

このサーバーは、対話型のクイズツールを提供します。

get_quiz: さまざまなカテゴリと難易度レベルのクイズ問題を提供します。

{
  "method": "tools/call",
  "params": {
    "name": "get_quiz",
    "arguments": {
      "category": "science",
      "difficulty": "medium"
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}

利用可能なカテゴリ：

• general
• science
• history
• geography
• entertainment

難易度レベル：

• easy
• medium
• hard

プロジェクト構造

quiz-mcp-template/
├── src/
│   └── index.ts       # メインの Quiz MCP サーバー実装ファイル
├── tests/
│   └── cli-mcp.test.ts # MCP 統合テストファイル
├── package.json
├── tsconfig.json
└── README.md

開発

クイズカテゴリの拡張

新しいクイズカテゴリや問題を追加するには、src/index.ts の quizQuestions オブジェクトを修正してください。

// 新しいカテゴリを追加
quizQuestions.newCategory = {
  easy: [
    { question: "Easy question 1?", answer: "Answer 1" },
    { question: "Easy question 2?", answer: "Answer 2" },
    // さらに問題を追加...
  ],
  medium: [
    { question: "Medium question 1?", answer: "Answer 1" },
    { question: "Medium question 2?", answer: "Answer 2" },
    // さらに問題を追加...
  ],
  hard: [
    { question: "Hard question 1?", answer: "Answer 1" },
    { question: "Hard question 2?", answer: "Answer 2" },
    // さらに問題を追加...
  ],
};

// 新しいカテゴリを含むようにスキーマを更新することを忘れないでください
const QuizSchema = z.object({
  category: z
    .enum([
      "general",
      "science",
      "history",
      "geography",
      "entertainment",
      "newCategory",
    ])
    .optional()
    .describe("The category of questions to ask"),
  // ...
});

📄 ライセンス

MIT

謝辞

このプロジェクトは、Anthropic によって開発されたモデルコンテキストプロトコル（MCP）を使用しており、AI アシスタント用の教育クイズツールを提供しています。

🔧 技術詳細

環境要件