scopey (Jpdesigntech)

Scopey MCP服务器

Scopey是一个个人MCP（模型上下文协议）服务器，旨在简化通用技术栈中的工作流程和上下文管理。它充当个人发展项目的集中集成中心和脚手架助手。

特性

• 线性积分：创建和阅读工单/问题
• Supabase集成：对数据库的只读访问
• Vercel集成：读取项目信息和部署的访问权限
• 项目脚手架：Vite和Next.js项目设置命令
• PRD一代：根据提供的代码上下文和提示生成PRD
• 光标规则生成：根据提示创建游标规则

快速开始

选项1：与NPX一起使用（推荐）

无需安装！只需添加到您的MCP客户端配置中：

{
  "mcpServers": {
    "scopey": {
      "command": "npx",
      "args": ["-y", "@jpdesign/scopey"],
      "env": {
        "LINEAR_API_KEY": "your_key",
        "SUPABASE_URL": "your_url",
        "SUPABASE_ANON_KEY": "your_key",
        "VERCEL_TOKEN": "your_token"
      }
    }
  }
}

选项2：全局安装

npm install -g @jpdesign/scopey

然后使用 scopey-mcp 配置中的命令：

{
  "mcpServers": {
    "scopey": {
      "command": "scopey-mcp",
      "env": {
        "LINEAR_API_KEY": "your_key",
        "SUPABASE_URL": "your_url",
        "SUPABASE_ANON_KEY": "your_key",
        "VERCEL_TOKEN": "your_token"
      }
    }
  }
}

选项3：从源代码安装

git clone https://github.com/yourusername/scopey-mcp-server.git
cd scopey-mcp-server
npm install
npm run build
npm link

配置

环境变量

创建一个 .env 使用API密钥文件：

LINEAR_API_KEY=your_linear_api_key
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_ANON_KEY=your_supabase_anon_key
VERCEL_TOKEN=your_vercel_token
VERCEL_TEAM_ID=your_vercel_team_id  # Optional

Claude桌面配置

将Scopey添加到您的Claude Desktop配置中：

按平台划分的位置：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json
• Linux： ~/.config/claude/claude_desktop_config.json

光标配置

添加到光标设置或创建 .vscode/mcp.json 在您的工作空间中。

可用工具

线性工具

• linear_create_ticket：在Linear中创建新票证/问题
• linear_read_tickets：从Linear读取/搜索门票
• linear_get_teams：获取Linear工作区中的团队列表
• liner_get_users：获取线性工作区中的用户列表

Supabase工具

• suabase_read_table：从Supabase表读取数据
• suabase_executequery：执行自定义辅助数据库查询
• suabase_list_tables：列出数据库中的所有表
• suabase_get_table_schema：获取特定表的架构

Vercel工具

• vercel_list_项目：列出Vercel帐户中的所有项目
• vercel_get-project：获取项目的详细信息
• vercel_list_部署：列出项目的部署
• vercel_get_部署：获取详细的部署信息
• vercel_get-domains：列出帐户中的所有域

脚手架工具

• scaffold_nextjs：创建一个新的Next.js项目
• 脚手架_现场：创建一个新的Vite项目
• add_common_dependency：向项目添加常见依赖项

发电机工具

• generate_prd：生成产品需求文档
• 生成器规则：生成游标规则配置
• generate_context_doc：生成上下文文档以供重用

例子

创建线性票

{
  "tool": "linear_create_ticket",
  "arguments": {
    "title": "Implement new authentication flow",
    "description": "Add OAuth2 support for Google and GitHub",
    "priority": 2,
    "labels": ["feature", "authentication"]
  }
}

阅读Supabase

{
  "tool": "supabase_read_table",
  "arguments": {
    "tableName": "users",
    "filter": {
      "active": true
    },
    "limit": 10
  }
}

搭建Next.js项目

{
  "tool": "scaffold_nextjs",
  "arguments": {
    "projectName": "my-app",
    "typescript": true,
    "tailwind": true,
    "app": true
  }
}

生成PRD

{
  "tool": "generate_prd",
  "arguments": {
    "context": "Existing e-commerce platform built with Next.js and Supabase",
    "prompt": "Add a recommendation engine that suggests products based on user behavior"
  }
}

发展

项目结构

scopey-mcp-server/
├── src/
│   ├── index.ts          # Main server entry point
│   ├── tools/            # Tool implementations
│   │   ├── linear.ts     # Linear integration
│   │   ├── supabase.ts   # Supabase integration
│   │   ├── vercel.ts     # Vercel integration
│   │   ├── scaffolding.ts # Project scaffolding
│   │   └── generator.ts  # PRD and rules generation
│   └── utils/            # Utility functions
│       └── types.ts      # TypeScript types
├── dist/                 # Compiled output
├── package.json
├── tsconfig.json
└── README.md

测试

npm test

代码检查

npm run lint

API密钥

线性

1. 首选 线性设置
2. 创建新的个人API密钥
3. 增添 .env 像 LINEAR_API_KEY

Supabase

1. 转到您的Supabase项目设置
2. 查找API部分
3. 复制URL和匿名密钥
4. 增添 .env 像 SUPABASE_URL 和 SUPABASE_ANON_KEY

维塞尔

1. 首选 Vercel帐户设置
2. 创建新令牌
3. 增添 .env 像 VERCEL_TOKEN
4. 可选择将您的团队ID添加为 VERCEL_TEAM_ID

贡献

1. 分叉存储库
2. 创建功能分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add some amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

许可证

MIT许可证-请参阅 许可证 详细信息文件

支持

有关问题、疑问或贡献，请访问 .