Luskad MCP

Luskad MCP

一个模型上下文协议（MCP）服务，可为你的项目提供编码规则和示例。

功能

• 项目管理：检索所有可用项目及其详细信息
• 编码规则：搜索并查看特定项目中的编码规范
• 团队协作：获取团队成员信息和项目联系人
• 进度跟踪：监控项目进度、风险和任务
• 功能管理：查看项目功能及其相关问题
• 灵活配置：支持环境变量和命令行参数
• 多平台支持：兼容 Cursor、Windsurf、VS Code 和 Claude Desktop

前置条件

• Node.js（v16 或更高版本）
• npm 或 yarn
• Cursor、Windsurf、Claude Desktop 或其他 MCP 客户端

你还需要在 luskad.com 应用上创建账户并生成 API 令牌。

开始使用

在 Cursor 中安装

前往：Settings -> Cursor Settings -> MCP -> Add new global MCP server

建议将以下配置粘贴到 Cursor 的 ~/.cursor/mcp.json 文件中。更多信息请参阅 Cursor MCP 文档。

{
  "mcpServers": {
    "Luskad": {
      "command": "npx",
      "args": ["-y", "@acmada/luskad-mcp"]
    }
  }
}

在 Windsurf 中安装

将以下内容添加到 Windsurf MCP 配置文件中。更多信息请参阅 Windsurf MCP 文档。

{
  "mcpServers": {
    "luskad": {
      "command": "npx",
      "args": ["-y", "@acmada/luskad-mcp"]
    }
  }
}

在 VSCode 中安装

将以下内容添加到 VS Code MCP 配置文件中。更多信息请参阅 VS Code MCP 文档。

{
  "servers": {
    "luskad": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@acmada/luskad-mcp"]
    }
  }
}

在 Claude Desktop 中安装

将以下内容添加到 Claude Desktop 的 claude_desktop_config.json 文件中。更多信息请参阅 Claude Desktop MCP 文档。

{
  "mcpServers": {
    "luskad": {
      "command": "npx",
      "args": ["-y", "@acmada/luskad-mcp"]
    }
  }
}

可用工具

list-projects

检索所有可用项目。

get-coding-rules

搜索指定项目的编码规则。参数：

• projectId：要搜索编码规则的项目
• query：（可选）搜索查询

开发

1. 克隆仓库：

git clone https://github.com/frocher/luskad-mcp.git
cd luskad-mcp

2. 安装依赖：

npm install

3. 构建

npm run build

配置

在根目录中创建 .env 文件，并添加以下变量：

API_URL=https://app.luskad.com/api/v1
API_KEY=<your api key>

或者通过命令行提供 URL：

node dist/index.js --url http://your-api-url --key <your api key>

本地配置示例

{
  "mcpServers": {
    "luskad": {
      "command": "npx",
      "args": [
        "tsx", "/path/to/folder/luskad-mcp/src/index.ts",
        "--url", "http://localhost:3000/api/v1",
        "--key", "<your personal key>"
      ]
    }
  }
}

使用 MCP Inspector 进行测试

npx -y @modelcontextprotocol/inspector npx @acmada/luskad-mcp@latest

许可证

MIT 许可证 - 详见 LICENSE。