@reus-able/frontend-helper-mcp 1.0.0

package/README.md

@@ -0,0 +1,60 @@
+# Frontend Helper MCP - Local Prompts
+
+这是一个简单的 MCP (Model Context Protocol) 服务器，专门用于将本地目录中的 Prompt 文件（`.md`, `.txt`, `.json`）暴露给 Cursor 或其他 MCP 客户端使用。
+
+## 功能
+
+- **List Prompts**: 自动扫描指定目录下的文件，并列出为可用的 Prompts。
+- **Get Prompt**: 读取文件内容并将其作为 Prompt 内容返回。
+
+## 快速开始
+
+### 1. 安装与构建
+
+确保你已安装 Node.js (v16+)。
+
+```bash
+# 安装依赖
+npm install
+
+# 构建项目
+npm run build
+```
+
+### 2. 在 Cursor 中配置
+
+打开 Cursor 的设置面板 (Settings) -> Features -> MCP，点击 "Add new MCP server"，并填入以下信息：
+
+- **Type**: `stdio`
+- **Name**: `local-prompts` (或你喜欢的任何名字)
+- **Command**: `node`
+- **Args**: 
+  - `/path/to/frontend-helper-mcp/dist/index.js` (注意替换为实际的绝对路径)
+  - `--dir`
+  - `/path/to/your/prompts/directory` (你存放 Prompt 文件的目录绝对路径)
+
+例如：
+```json
+{
+  "mcpServers": {
+    "local-prompts": {
+      "command": "node",
+      "args": [
+        "/Users/username/Work/frontend-helper-mcp/dist/index.js",
+        "--dir",
+        "/Users/username/my-prompts"
+      ]
+    }
+  }
+}
+```
+
+### 3. 使用方法
+
+1. 在配置的 Prompt 目录下创建文件，例如 `code-review.md`。
+2. 在 Cursor 的 Chat 界面中，点击 "Prompts" 或输入 `/`，你应该能看到 `code-review` 出现在列表中。
+3. 选择它，文件的内容就会被加载到当前的对话上下文中。
+
+## 命令行参数
+
+- `--dir` / `-d`: 指定 Prompt 文件所在的目录。默认为当前目录下的 `./prompts`。

package/dist/index.js

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+import { ListPromptsRequestSchema, GetPromptRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import fs from 'fs/promises';
+import path from 'path';
+import yargs from 'yargs';
+import { hideBin } from 'yargs/helpers';
+import { fileURLToPath } from 'url';
+import express from 'express';
+import cors from 'cors';
+async function createServer(promptsDir) {
+    const __dirname = path.dirname(fileURLToPath(import.meta.url));
+    const packageJsonPath = path.resolve(__dirname, '../package.json');
+    const packageJson = JSON.parse(await fs.readFile(packageJsonPath, 'utf-8'));
+    const mcpServer = new McpServer({
+        name: packageJson.name,
+        version: packageJson.version,
+    }, {
+        capabilities: {
+            prompts: {},
+        },
+    });
+    mcpServer.server.setRequestHandler(ListPromptsRequestSchema, async () => {
+        try {
+            // Ensure dir exists
+            try {
+                await fs.access(promptsDir);
+            }
+            catch {
+                console.error(`Directory ${promptsDir} does not exist.`);
+                return { prompts: [] };
+            }
+            const files = await fs.readdir(promptsDir);
+            const promptFiles = files.filter((f) => ['.txt', '.md', '.json'].includes(path.extname(f).toLowerCase()));
+            const prompts = promptFiles.map((file) => {
+                const name = path.parse(file).name;
+                return {
+                    name: name,
+                    description: `Content of ${file}`,
+                };
+            });
+            return { prompts };
+        }
+        catch (error) {
+            console.error('Error listing prompts:', error);
+            return { prompts: [] };
+        }
+    });
+    mcpServer.server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+        const promptName = request.params.name;
+        try {
+            const files = await fs.readdir(promptsDir);
+            const file = files.find((f) => path.parse(f).name === promptName &&
+                ['.txt', '.md', '.json'].includes(path.extname(f).toLowerCase()));
+            if (!file) {
+                throw new Error(`Prompt not found: ${promptName}`);
+            }
+            const content = await fs.readFile(path.join(promptsDir, file), 'utf-8');
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: content,
+                        },
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to load prompt ${promptName}: ${error}`);
+        }
+    });
+    return mcpServer;
+}
+async function main() {
+    const __dirname = path.dirname(fileURLToPath(import.meta.url));
+    const packageJsonPath = path.resolve(__dirname, '../package.json');
+    const packageJson = JSON.parse(await fs.readFile(packageJsonPath, 'utf-8'));
+    const argv = await yargs(hideBin(process.argv))
+        .option('transport', {
+        alias: 't',
+        type: 'string',
+        choices: ['stdio', 'sse'],
+        default: 'stdio',
+        description: 'Transport mode (stdio or sse)',
+    })
+        .option('port', {
+        alias: 'p',
+        type: 'number',
+        default: 3000,
+        description: 'Port to listen on (only for sse transport)',
+    })
+        .help()
+        .parse();
+    const promptsDir = path.resolve(__dirname, '../prompts');
+    if (argv.transport === 'sse') {
+        const app = express();
+        app.use(cors());
+        // Store active sessions: sessionId -> { server, transport }
+        const sessions = new Map();
+        app.get('/sse', async (req, res) => {
+            console.log(`New SSE connection from ${req.ip}`);
+            const mcpServer = await createServer(promptsDir);
+            const transport = new SSEServerTransport('/messages', res);
+            await mcpServer.connect(transport);
+            sessions.set(transport.sessionId, { server: mcpServer, transport });
+            transport.onclose = () => {
+                console.log(`Session closed: ${transport.sessionId}`);
+                sessions.delete(transport.sessionId);
+            };
+            await transport.start();
+        });
+        app.post('/messages', async (req, res) => {
+            const sessionId = req.query.sessionId;
+            if (!sessionId) {
+                res.status(400).send('Missing sessionId');
+                return;
+            }
+            const session = sessions.get(sessionId);
+            if (!session) {
+                res.status(404).send('Session not found');
+                return;
+            }
+            await session.transport.handlePostMessage(req, res);
+        });
+        app.listen(argv.port, () => {
+            console.log(`MCP Server running on SSE mode at http://localhost:${argv.port}/sse`);
+            console.log(`Prompts directory: ${promptsDir}`);
+        });
+    }
+    else {
+        console.error(`Starting MCP server serving prompts from: ${promptsDir}`);
+        const mcpServer = await createServer(promptsDir);
+        const transport = new StdioServerTransport();
+        await mcpServer.connect(transport);
+    }
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,39 @@
+{
+  "description": "前端开发的一些cursor mcp工具集",
+  "name": "@reus-able/frontend-helper-mcp",
+  "version": "1.0.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "prompts"
+  ],
+  "bin": {
+    "mcp-prompts": "./dist/index.js"
+  },
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "cors": "^2.8.5",
+    "express": "^5.2.1",
+    "yargs": "^18.0.0",
+    "zod": "^4.2.1"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.0.3",
+    "@types/yargs": "^17.0.35",
+    "typescript": "^5.9.3"
+  }
+}

package/prompts/demo.md

@@ -0,0 +1 @@
+Hello from MCP Prompt