Avantjohn MCP Server Test 04

🚀 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 協議。