cursor-integration

聚义厅MCP与Cursor集成指南

Cursor MCP配置

基础配置

在Cursor的设置中添加以下MCP服务器配置：

{
  "mcpServers": {
    "juyiting": {
      "command": "npx",
      "args": ["-y", "@juyiting/mcp-client"],
      "env": {
        "JUYITING_CONFIG_PATH": "~/.juyiting/config.json"
      }
    }
  }
}

开发环境配置

用于本地开发和调试：

{
  "mcpServers": {
    "juyiting-dev": {
      "command": "node",
      "args": [
        "/path/to/juyitingmcp/dist/server.js",
        "--personas", "/path/to/local-personas.json"
      ],
      "env": {
        "NODE_ENV": "development",
        "DEBUG": "true",
        "TELEMETRY_ENABLED": "false"
      }
    }
  }
}

高级配置选项

{
  "mcpServers": {
    "juyiting": {
      "command": "node",
      "args": [
        "/usr/local/bin/juyiting-mcp",
        "--config", "~/.juyiting/config.json",
        "--cache-duration", "300000",
        "--max-retries", "3"
      ],
      "env": {
        "JUYITING_API_URL": "https://api.juyiting.com",
        "JUYITING_CACHE_DIR": "~/.juyiting/cache",
        "TELEMETRY_ENABLED": "true"
      }
    }
  }
}

用户配置设置

初始配置

首次使用需要设置用户认证密钥：

# 创建配置目录
mkdir -p ~/.juyiting

# 设置用户密钥
echo '{
  "userKey": "your-api-key-from-juyiting-web",
  "apiBaseUrl": "https://api.juyiting.com",
  "cache": {
    "duration": 300000,
    "maxSize": 1000
  },
  "sync": {
    "autoSync": true,
    "syncInterval": 3600000,
    "retryAttempts": 3
  }
}' > ~/.juyiting/config.json

配置文件详解

interface LocalConfig {
  userKey: string;                    // 聚义厅Web平台获取的API密钥
  apiBaseUrl: string;                 // API服务地址，默认官方服务
  currentConfig?: PersonaConfig;       // 当前激活的人格配置
  lastSyncTime?: string;              // 最后同步时间
  
  cache: {
    duration: number;                 // 缓存时长（毫秒），默认5分钟
    maxSize: number;                  // 最大缓存条目，默认1000
  };
  
  sync: {
    autoSync: boolean;                // 是否自动同步配置，默认true
    syncInterval: number;             // 同步间隔（毫秒），默认1小时
    retryAttempts: number;            // 重试次数，默认3次
  };
}