Avantjohn MCP Server Test 04

🚀 Popmelt MCP サーバー

Popmelt MCP サーバーは、強力なツールであり、主にタレント（Talent）の設定ファイルとその関連属性の管理と操作に使用されます。このサーバーは PostgreSQL データベースに接続でき、MCP プロトコルを通じた相互作用をサポートしています。

✨ 主な機能

• タレント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

💻 使用例

MCP クライアントの使用

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 スタイルを生成し、2 つの異なるタレントスタイル間の互換性を分析する方法を示しています。

📚 ドキュメント

プロジェクト構造

- 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 の下でライセンスされています。