welcome-text-generator-mcp

歓迎文ジェネレーター MCP サーバー

新入社員向けのプロフェッショナルな歓迎文を自動生成する Model Context Protocol（MCP）サーバーです。自由記述の情報から構造化データを抽出し、モジュール式でカスタマイズ可能なオンボーディング文を作成します。

機能

📝 テキスト分析：社員に関する自由記述の情報を処理します
🎯 モジュール式テンプレートシステム：さまざまなバリエーションを備えた5つの柔軟なモジュール
💾 データ保存：抽出したデータを後で使用できるよう保存します
🔄 一覧管理：保存されている社員データをすべて一覧表示します

インストール

前提条件

• Node.js（v18 以降）
• Claude Desktop App

ステップ 1：NPM でインストール

npm install -g welcome-text-generator-mcp

または、ローカルで開発する場合：

git clone https://github.com/goodfel10w/WelcomeTextGenerator.git
cd WelcomeTextGenerator
npm install
npm run build

ステップ 2：Claude Desktop の設定

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

MCP サーバーを追加します：

{
  "mcpServers": {
    "welcome-text-generator": {
      "command": "node",
      "args": [
        "C:\\Pfad\\zum\\Projekt\\dist\\index.js"
      ],
      "env": {}
    }
  }
}

NPM でグローバルインストールした場合：

{
  "mcpServers": {
    "welcome-text-generator": {
      "command": "npx",
      "args": ["welcome-text-generator-mcp"],
      "env": {}
    }
  }
}

ステップ 3：Claude Desktop を再起動

MCP サーバーを読み込むため、Claude Desktop App を再起動します。

利用可能なツール

1. extract_from_text

自由記述から構造化データを抽出します。

パラメーター：

• text（string）：社員に関する情報を含む自由記述

例：

{
  "text": "Max Mustermann - Senior Developer mit 5 Jahren Erfahrung. Skills: JavaScript, TypeScript, React..."
}

2. generate_modular_welcome_text

テンプレートシステムに従って、モジュール式の歓迎文を生成します。

パラメーター：

• data（object）：抽出した社員データ

  • name（string、必須）
  • position（string、任意）
  • previousCompany（string、任意）
  • skills（array、必須）
  • experience（string、任意）
  • achievements（array、必須）
  • interests（array、必須）

• moduleOptions（object、任意）：

  • includeCompetencies（boolean、デフォルト：true）：モジュール2を含めます
  • includeFunFact（boolean、デフォルト：false）：モジュール3を含めます
  • includeExperience（boolean、デフォルト：true）：モジュール4を含めます
  • introductionVariant（string、デフォルト："variant1"）："variant1"、"variant2"、または"variant3"
  • closingVariant（string、デフォルト："variant1"）："variant1"、"variant2"、または"variant3"

3. list_extracted_data

保存されている社員データをすべて一覧表示します。

パラメーターは不要です

モジュールシステム

生成されるテキストは5つのモジュールで構成されます：

モジュール 1：挨拶と導入（必須）

3つのバリエーションがあります：

• バリエーション 1：「[NAME]さん、ようこそ！新鮮な視点で……」
• バリエーション 2：「[NAME]さんを迎えられることを、とても嬉しく思います！……」
• バリエーション 3：「[NAME]さん、心より歓迎します！……」

モジュール 2：能力と強み（任意）

社員の専門知識と情熱について説明します。

モジュール 3：豆知識（任意）

社員に関する、個人的で興味深い情報です。

モジュール 4：職歴（任意）

これまでのキャリアと実績に関する情報です。

モジュール 5：締めくくりと歓迎の言葉（必須）

3つのバリエーションがあります：

• バリエーション 1：「[NAME]さん、チームへようこそ！……」
• バリエーション 2：「[NAME]さんを迎えられて、とても嬉しいです！……」
• バリエーション 3：「[NAME]さんがチームの一員になってくれて嬉しいです！……」

使用例

Claude Chat で：

Ich: Hier sind die Informationen über unseren neuen Mitarbeiter:
Max Mustermann - Senior Developer mit 5 Jahren Erfahrung in JavaScript, TypeScript und React.
Hat zuvor bei TechCorp gearbeitet und mehrere erfolgreiche Projekte geleitet.
Begeisterter Marathonläufer.

Claude: Ich extrahiere die Daten aus dem Text...
[verwendet extract_from_text Tool]

Ich: Erstelle einen Willkommenstext mit Variante 2 für die Begrüßung
und füge einen Fun Fact hinzu.

Claude: [verwendet generate_modular_welcome_text mit entsprechenden Optionen]

Ausgabe:
Wir freuen uns riesig, Max Mustermann bei uns begrüßen zu dürfen!
Ab sofort verstärkt er unser Team im Bereich Development als Senior
Developer und bringt dabei wertvolle Erfahrung und neue Impulse mit.

Max bringt nicht nur umfangreiche Kenntnisse in JavaScript und
TypeScript mit, sondern auch jede Menge Energie und Leidenschaft
für moderne Webentwicklung.

Fun Fact über Max: Wusstest du, dass er ein begeisterter
Marathonläufer ist? Vielleicht erleben wir das bald gemeinsam im Team!

Herzlich willkommen im Team, Max Mustermann! Lass uns gemeinsam
großartige Dinge erreichen. Schön, dass du da bist!

データ保存

抽出されたデータはすべて、次の場所に自動保存されます：

<Projektverzeichnis>/data/extracted_data.json

各エントリーには次の情報が含まれます：

• id：一意の ID（タイムスタンプ）
• timestamp：ISO 8601 タイムスタンプ
• source：データのソース（「手動で入力したテキスト」）
• data：抽出された社員データ

開発

プロジェクトをローカルで起動

npm run dev

ビルドを作成

npm run build

テストを実行

npm test

技術スタック

• TypeScript：型安全なコード
• MCP SDK：Model Context Protocol の統合
• Zod：スキーマ検証

プロジェクト構成

welcome-text-generator-mcp/
├── src/
│   ├── index.ts                 # Server-Einstiegspunkt
│   ├── types.ts                 # TypeScript-Typen
│   ├── tools/                   # MCP Tools
│   │   ├── extractFromTextTool.ts
│   │   ├── generateModularTextTool.ts
│   │   └── listDataTool.ts
│   ├── utils/                   # Hilfsfunktionen
│   │   ├── textExtractor.ts
│   │   └── moduleTextGenerator.ts
│   ├── templates/               # Text-Templates
│   │   └── moduleTemplates.ts
│   └── storage/                 # Datenspeicherung
│       └── dataStorage.ts
├── dist/                        # Kompilierte Dateien
├── data/                        # Gespeicherte Daten
├── package.json
├── tsconfig.json
└── README.md

ライセンス

MIT License - LICENSE ファイルを参照してください

貢献

貢献を歓迎します！プルリクエストを作成するか、Issue を開いてください。

サポート

ご質問や問題がある場合：

• GitHub Issues: https://github.com/goodfel10w/WelcomeTextGenerator/issues
• MCP ドキュメント: https://modelcontextprotocol.io

変更履歴

バージョン 1.0.0

• 初回リリース
• テキストの抽出と分析
• 5 つのモジュールを備えたモジュール式テンプレートシステム
• データの保存と管理
• 導入と締めくくりの 3 種類のバリエーション