Welcometextgenerator

🚀 歡迎文本生成器MCP服務器

這是一個模型上下文協議（MCP）服務器，用於自動為新員工生成專業的歡迎文本。它可以從自由文本信息中提取結構化數據，並創建模塊化、可定製的入職文本。

✨ 主要特性

• 📝 文本分析：處理有關員工的自由文本信息。
• 🎯 模塊化模板系統：提供5個靈活的模塊，每個模塊有不同的變體。
• 💾 數據存儲：存儲提取的數據，供日後使用。
• 🔄 概覽管理：列出所有存儲的員工數據。

📦 安裝指南

前提條件

• Node.js（v18或更高版本）
• Claude桌面應用程序

步驟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桌面配置

打開Claude桌面配置文件：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

添加MCP服務器： 如果是通過NPM全局安裝：

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

如果是本地開發安裝：

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

步驟3：重新啟動Claude桌面應用程序

重新啟動Claude桌面應用程序，以便加載MCP服務器。

💻 使用示例

可用工具

1. extract_from_text

從自由文本中提取結構化數據。 參數：

• text（字符串）：包含員工信息的自由文本。 示例：

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

2. generate_modular_welcome_text

根據模板系統生成模塊化的歡迎文本。 參數：

• data（對象）：提取的員工數據
  • name（字符串，必填）
  • position（字符串，可選）
  • previousCompany（字符串，可選）
  • skills（數組，必填）
  • experience（字符串，可選）
  • achievements（數組，必填）
  • interests（數組，必填）
• moduleOptions（對象，可選）：
  • includeCompetencies（布爾值，默認值：true）：包含模塊2
  • includeFunFact（布爾值，默認值：false）：包含模塊3
  • includeExperience（布爾值，默認值：true）：包含模塊4
  • introductionVariant（字符串，默認值："variant1"）："variant1"、"variant2"或"variant3"
  • closingVariant（字符串，默認值："variant1"）："variant1"、"variant2"或"variant3"

3. list_extracted_data

列出所有存儲的員工數據。 無需參數

模塊系統

生成的文本由5個模塊組成：

模塊1：歡迎與介紹（必填）

有3種變體可供選擇：

• 變體1："Welcome to [NAME]! Mit einem frischen Blick..."
• 變體2："Wir freuen uns riesig, [NAME] bei uns begrüßen zu dürfen!..."
• 變體3："Ein herzliches Willkommen an [NAME]!..."

模塊2：能力與優勢（可選）

描述員工的專業知識和熱情。

模塊3：趣味事實（可選）

關於員工的個人有趣信息。

模塊4：職業發展（可選）

關於員工以往職業經歷和成就的信息。

模塊5：結束語與歡迎問候（必填）

有3種變體可供選擇：

• 變體1："Herzlich willkommen im Team, [NAME]!..."
• 變體2："Wir freuen uns sehr, dich an Bord zu haben, [NAME]!..."
• 變體3："Schön, dass du jetzt Teil unseres Teams bist, [NAME]!..."

實際使用示例

在Claude聊天中：

我：以下是我們新員工的信息：
Max Mustermann - 擁有5年經驗的高級開發人員，精通JavaScript、TypeScript和React。
曾在TechCorp工作，並領導過多個成功的項目。
是一位狂熱的馬拉松愛好者。

Claude：我從文本中提取數據...
[使用extract_from_text工具]

我：使用變體2生成歡迎文本，並添加一個趣味事實。

Claude：[使用generate_modular_welcome_text並設置相應選項]

輸出：
我們非常高興能歡迎Max Mustermann加入我們！
從現在起，他將作為高級開發人員加強我們的開發團隊，並帶來寶貴的經驗和新的靈感。

Max不僅擁有豐富的JavaScript和TypeScript知識，還對現代Web開發充滿熱情和活力。

關於Max的趣味事實：你知道嗎，他是一位狂熱的馬拉松愛好者！也許我們很快能在團隊中一起體驗！

熱烈歡迎Max Mustermann加入團隊！讓我們一起創造偉大的成就。很高興你加入我們！

🔧 技術細節

數據存儲

所有提取的數據將自動存儲在：

<項目目錄>/data/extracted_data.json

每個條目包含：

• id：唯一ID（時間戳）
• timestamp：ISO 8601時間戳
• source：數據來源（"手動文本輸入"）
• data：提取的員工數據

開發

本地啟動項目

npm run dev

構建項目

npm run build

運行測試

npm test

技術棧

• TypeScript：類型安全的代碼
• MCP SDK：模型上下文協議集成
• Zod：模式驗證

項目結構

welcome-text-generator-mcp/
├── src/
│   ├── index.ts                 # 服務器入口點
│   ├── types.ts                 # TypeScript類型
│   ├── tools/                   # MCP工具
│   │   ├── extractFromTextTool.ts
│   │   ├── generateModularTextTool.ts
│   │   └── listDataTool.ts
│   ├── utils/                   # 輔助函數
│   │   ├── textExtractor.ts
│   │   └── moduleTextGenerator.ts
│   ├── templates/               # 文本模板
│   │   └── moduleTemplates.ts
│   └── storage/                 # 數據存儲
│       └── dataStorage.ts
├── dist/                        # 編譯後的文件
├── data/                        # 存儲的數據
├── package.json
├── tsconfig.json
└── README.md

📄 許可證

本項目採用MIT許可證，請參閱LICENSE文件。

貢獻

歡迎貢獻代碼！請創建一個Pull Request或打開一個Issue。

支持

如有任何問題或疑問：

• GitHub問題：https://github.com/goodfel10w/WelcomeTextGenerator/issues
• MCP文檔：https://modelcontextprotocol.io

更新日誌

版本1.0.0

• 初始版本發佈
• 文本提取和分析
• 具有5個模塊的模塊化模板系統
• 數據存儲和管理
• 介紹和結束語各有3種變體