welcome-text-generator-mcp

欢迎文本生成器 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 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

重新启动 Claude 桌面应用，以加载 MCP 服务。

可用工具

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 聊天中：

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：模型上下文协议集成
• 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 文件

贡献

欢迎贡献！请创建 Pull Request 或提交 Issue。

支持

如有疑问或遇到问题：

• GitHub Issues：https://github.com/goodfel10w/WelcomeTextGenerator/issues
• MCP 文档：https://modelcontextprotocol.io

更新日志

版本 1.0.0

• 首次发布
• 文本提取与分析
• 包含 5 个模块的模块化模板系统
• 数据存储与管理
• 3 种开场和结尾变体