中文命名MCP工具集

🎯 专业中文命名工具集 -基于传统文化与现代科技的智能命名分析与生成系统

🌟 特性

核心工具

• 中文名字生成器 -基于传统文化与现代需求的智能化命名
• 名字意义分析器 -深入分析名字的文化内涵和象征意义
• 名字重复检查器 -评估名字的独特性和重复风险

高级分析工具

• 八字分析器 -传统数术分析，优化五行配置
• 音韵分析器 -分析名字的音韵美感和发音流畅度
• 文化分析器 -深入探索名字的文化层次和历史渊源
• 诗歌生成器 -基于名字创作各种形式的诗歌
• 运势分析器 -预测并建议传统命理运势
• 风水分析器 -分析名字的风水属性及其影响
• 历史典故分析器 -探索名字中的历史典故和名人轶事

🚀 快速开始

安装

# 克隆项目
git clone https://github.com/SiwuXue/chinese-naming-mcp-toolset.git
cd chinese-naming-mcp-toolset

# 安装依赖
npm install

# 运行项目
npm start

MCP客户端配置

此工具集支持标准MCP（模型上下文协议）协议，并可在支持MCP的客户端中使用。

Claude Desktop配置

在Claude Desktop的配置文件中添加以下配置：

Windows配置路径： %APPDATA%\Claude\claude_desktop_config.json MacOS配置路径： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "chinese-naming": {
      "command": "npx",
      "args": ["chinese-naming-mcp"]
    }
  }
}

验证连接

完成配置后，重启客户端，您应该能看到以下10个中文命名工具：

• 🎯 chinese-name-generator -中文名字生成器
• 📖 name-meaning-analyzer -名字意义分析器
• 🔍 name-collision-checker -名字重复检查器
• ☯️ name-bazi-analyzer -名字八字分析器
• 🎵 name-phonetic-analyzer -名字音韵分析器
• 🏛️ name-cultural-analyzer -名字文化分析器
• 📝 name-poetry-generator -名字诗歌生成器
• 🔮 name-fortune-analyzer -名字运势分析器
• 🏔️ name-fengshui-analyzer -名字风水分析器
• 📚 name-history-analyzer -名字历史分析器

🔧 故障排除

如果您遇到MCP错误 -32000: 连接关闭，请参考故障排除指南。

快速诊断

运行测试脚本以验证MCP服务器状态：

node test-mcp-connection.js

常见解决方案

1. 检查配置文件：确保claude_desktop_config.json格式正确
2. 重启Claude Desktop：修改配置后需要完全重启
3. 验证环境：确保Node.js>=14.0.0和npm正常工作
4. 检查权限：确保有足够的文件系统权限

基本用法

# 生成姓名
node index.js generate --surname 李 --gender male --style traditional

# 分析姓名
node index.js analyze --name 李明华 --depth detailed

# 检查重名
node index.js check-collision --name 王伟 --region beijing

# 八字分析
node index.js bazi-analyze --name 张三 --birth-year 1 990 --birth-month 5 --birth-day 15 --birth-hour 14

MCP客户端使用示例

在支持MCP的客户端中，可以直接调用工具：

请帮我生成3个适合女孩的现代风格姓名，姓氏是"李"

请分析"王雅琪"这个名字的文化内涵和含义

请检查"张伟"这个名字的重名情况

请根据1990年5月15日上午10点的生辰八字，分析"李明华"这个名字的五行配置

📚 工具详细解释

1. 中文名字生成器

智能生成符合中国传统和现代审美的名字。

特性：

• 支持多种风格，如传统、现代、诗意和五行
• 可指定期望字符和禁忌字符
• 自动计算拼音、笔画、含义和评分
• 提供详细的生成原因和文化背景

使用示例：

const generator = new ChineseNameGenerator();
const result = await generator.execute({
  surname: '李',
  gender: 'male',
  style: 'traditional',
  desiredChars: ['明', '华'],
  avoidChars: ['病', '死'],
  count: 5
});

2. 姓名含义分析器

深入分析名字的文化内涵、字义和象征意义。

分析维度：

• 基础分析：字义、拼音、笔画
• 详细分析：文化内涵、象征意义、历史背景
• 综合分析：现代解读、教育价值和启发意义

3. 名字重复检查器

评估名字的独特性和不同地区的相似性。

检查内容：

• 重复频率估计
• 区域分布分析
• 独特性评分
• 风险等级评估
• 推荐相似名字

4. 名字八字分析器

基于传统数术，分析名字的八字和五行配置。

分析元素：

• 八字计算（年、月、日、时）
• 五行属性分析
• 根据神喜神忌判断
• 名字五行配置
• 运势预测和建议

5. 音韵分析器

分析名字的音韵美感、声调协调性和发音流畅度。

分析项目：

• 声调组合分析
• 韵律和谐
• 发音流畅度
• 音韵风格识别
• 地方口音适应性

6. 名字文化分析器

深入探索名字的文化层次、历史起源和哲学内涵。

文化维度：

• 古典文化层次
• 反映的哲学思想
• 历史文化背景
• 现代文化价值观
• 跨文化交流理解

7. 名字诗歌生成器

基于名字创作各种形式的诗歌。

诗歌类型：

• 隐藏诗：名字作为每句开头
• 嵌入诗：名字自然嵌入诗句
• 可正读反读的诗句
• 拆字诗：基于字形结构创作
• 主题诗：围绕名字的意义创作主题

8. 运势分析器

基于传统命理学的名字运势分析和生活预测。

分析内容：

• 五格数学计算
• 三才配置分析
• 各方面运势预测
• 生活阶段运势
• 改运建议

9. 名字风水分析器

分析名字的风水属性及其对个人运势的影响。

风水要素：

• 八卦属性分析
• 方位属性配置
• 风水格局评估
• 调整建议
• 应用指导

10. 名字历史分析器

探索名字中的历史典故、文化内涵和名人轶事。

分析范围：

• 历史名人关联
• 经典典故引用
• 文学作品起源
• 文化符号意义
• 反映的哲学思想

🛠️ 开发指南

添加新工具

1. 继承BaseTool类
2. 实现必要的方法：
   • execute(params) -主要执行逻辑
   • getParameterSchema() -参数模式定义
   • getUsageExamples() -示例用法

const BaseTool = require('../utils/base-tool');

class MyNewTool extends BaseTool {
  constructor() {
    super();
    this.name = 'my-new-tool';
    this.description = '我的新工具';
  }

  async execute(params) {
    // 实现工具逻辑
    return this.createResponse(true, '执行成功', result);
  }

  getParameterSchema() {
    return {
      type: 'object',
      properties: {
        // 定义参数
      },
      required: []
    };
  }

  getUsageExamples() {
    return [
      {
        description: '示例描述',
        input: { /* 示例输入 */ }
      }
    ];
  }
}

module.exports = MyNewTool;

测试

# 运行所有测试
npm test

# 运行特定工具测试
npm run test:generator
npm run test:analyzer

# 代码覆盖率
npm run coverage

代码规范

# 代码检查
npm run lint

# 代码格式化
npm run format

📖 API文档

统一响应格式

所有工具返回统一的响应格式：

{
  success: boolean,     // 执行是否成功
  message: string,      // 响应消息
  data: object,         // 结果数据
  timestamp: string,    // 时间戳
  toolName: string      // 工具名称
}

错误处理

当工具执行失败时，返回错误消息：

{
  success: false,
  message: "错误描述",
  error: {
    code: "ERROR_CODE",
    details: "详细错误信息"
  },
  timestamp: "2024-01-01T00:00:00.000Z",
  toolName: "tool-name"
}

🤝 贡献指南

1. Fork项目
2. 创建功能分支（git checkout -b feature/AmazingFeature）
3. 提交更改（git commit -m 'Add some AmazingFeature'）
4. 推送到分支（git push origin feature/AmazingFeature）
5. 打开Pull Request

📄 许可证

本项目采用MIT许可证 - 查看LICENSE文档详情。

🙏 致谢

• 感谢所有贡献者的努力
• 感谢深厚的中国传统文化基础
• 感谢开源社区的支持

📞 联系我们

• 项目主页：GitHub
• 问题反馈：Issues
• 邮箱：3488909960@qq.com

---

注意此工具集仅供参考和娱乐用途，不应作为重大人生决策的唯一依据。传统文化的分析结果具有主观性，请理性对待。