🚀 Popmelt MCP 服务器

Popmelt MCP 服务器是一款强大的工具，主要用于管理和操作人才（Talent）配置文件及其相关属性。它能连接到 PostgreSQL 数据库，并支持通过 MCP 协议进行交互，为人才管理提供了高效、便捷的解决方案。

🚀 快速开始

安装依赖

npm install

设置环境变量

编辑 .env 文件：

# 数据库连接配置
DB_HOST=your-database-host
DB_PORT=5432
DB_NAME=your-database-name
DB_USER=your-database-user
DB_PASSWORD=your-database-password

启动服务器

npm run start

✨ 主要特性

• 人才AI配置文件访问：提供对人才配置文件的读取功能。
• 特定人才信息获取：允许通过 ID 查询特定人才的信息。
• 人才属性查询：支持通过 ID 和属性名称查询人才的具体属性（支持点符号表示法嵌套查询）。
• 组件样式生成：基于人才配置文件生成指定组件的 CSS 样式表。
• CSS 生成工具：提供生成单个组件或完整组件库的 CSS 功能。
• 人才查询工具：支持对人才元数据进行 ReadOnly 查询操作。
• 风格兼容性分析工具：能够分析不同人才风格之间的兼容性。

📦 安装指南

安装依赖

npm install

设置环境变量

编辑 .env 文件，配置数据库连接信息：

# 数据库连接配置
DB_HOST=your-database-host
DB_PORT=5432
DB_NAME=your-database-name
DB_USER=your-database-user
DB_PASSWORD=your-database-password

启动服务器

npm run start

💻 使用示例

基础用法

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';

// 创建传输通道
const transport = new StdioClientTransport({
  command: 'node',
  args: ['dist/server.js']
});

// 初始化客户端
const client = new Client(
  { name: '示例客户端', version: '1.0.0' },
  { capabilities: { resources: {}, tools: {} } }
);

// 连接服务器
await client.connect(transport);

// 获取所有人才信息
const 所有talent = await client.listResources('talent://');

// 获取特定人才信息
const talent = await client.readResource('talent://现代极简主义');

// 生成组件 CSS 样式
const css = await client.callTool({
  name: 'generate-css',
  arguments: {
    talentId: 'modern-minimalist',
    component: 'button',
    state: 'hover'
  }
});

// 分析风格兼容性
const 兼容性分析结果 = await client.callTool({
  name: 'analyze-style-compatibility',
  arguments: {
    talentId1: '现代极简主义',
    talentId2: '大胆活力'
  }
});

高级用法

node examples/generate-css.js

这个示例脚本展示了如何使用 MCP 客户端生成所有可用人才的 CSS 样式，并分析两种不同人才风格之间的兼容性。

📚 详细文档

项目结构

- dist/                 # 编译后的输出目录
- src/
    - index.ts         # 入口文件
    - server.ts       # 服务器核心逻辑
    - database.ts     # 数据库连接与操作
    - tools/
        - generate_css.ts   # CSS 生效工具
        - analyze_compatibility.ts # 风格兼容性分析工具

数据库模式

CREATE TABLE talents (
    id SERIAL PRIMARY KEY,
    name VARCHAR(255),
    description TEXT,
    attributes JSONB NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

说明：attributes字段存储人才配置文件的属性信息，采用JSONB格式以便于复杂结构的数据存储与查询。

API 参考

资源接口

• 人才配置文件列表：talent://
• 特定人才信息：talent://{id}
• 人才属性查询：talent-attribute://{id}/{attribute}
• 组件样式获取：component-style://{talent_id}/{component_name}

工具接口

• 生成 CSS 样式：generate-css
• 生成组件库：generate-component-library
• 人才查询：query-talents
• 风格兼容性分析：analyze-style-compatibility

🔧 技术细节

开发指南

• 调试：npm run debug
• 测试：npm test

📄 许可证

该项目遵循 MIT License 协议。