flex-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 llj
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,154 @@
+# flex-mcp
+
+可运营 MCP Node 服务 - 支持多用户管理、MCP 协议、脚本执行。
+
+## 安装
+
+```bash
+npm install flex-mcp
+```
+
+## 快速开始
+
+### 一键部署（推荐）
+
+```bash
+# 全局安装
+npm install -g flex-mcp
+
+# 一键部署（初始化 + 启动）
+meta-mcp deploy
+```
+
+### 命令行使用
+
+```bash
+# 初始化项目（创建 .env 文件，初始化数据库）
+meta-mcp init
+
+# 启动服务器
+meta-mcp start
+
+# 查看帮助
+meta-mcp help
+```
+
+### 使用 npx（无需安装）
+
+```bash
+# 一键部署
+npx flex-mcp deploy
+
+# 初始化
+npx flex-mcp init
+
+# 启动
+npx flex-mcp start
+```
+
+### 在代码中使用
+
+```typescript
+import { startServer } from 'flex-mcp';
+
+await startServer({
+  port: 3000,
+  host: '0.0.0.0',
+});
+```
+
+## 环境变量
+
+- `PORT`: 服务器端口（默认: 3000）
+- `HOST`: 服务器主机（默认: 0.0.0.0）
+- `DATABASE_URL`: 数据库路径（默认: ./data/database.sqlite）
+- `JWT_SECRET`: JWT 密钥（生产环境请修改）
+- `ADMIN_USERNAME`: 超级管理员用户名（默认: admin）
+- `ADMIN_PASSWORD`: 超级管理员密码（默认: 123456）
+- `CORS_ORIGIN`: CORS 来源（默认: *）
+
+### 使用统计（可选）
+
+- `DISABLE_TELEMETRY`: 禁用统计（设置为 `true` 或 `1`）
+
+统计功能默认启用，用于了解工具使用情况。如需禁用，请设置 `DISABLE_TELEMETRY=true`。
+
+详细说明请参考 [TELEMETRY.md](./TELEMETRY.md)
+
+## 功能特性
+
+- ✅ MCP 协议支持（SSE + HTTP）
+- ✅ 多用户管理和认证
+- ✅ MCP 组件加载（NPM/URL/stdio）
+- ✅ TypeScript 脚本执行
+- ✅ 变量系统
+- ✅ REST API
+
+## 连接 Cursor
+
+在 Cursor 的 MCP 配置中添加：
+
+```json
+{
+  "mcpServers": {
+    "flex-mcp": {
+      "url": "http://localhost:3000/mcp/sse",
+      "headers": {
+        "email": "YOUR_EMAIL",
+        "apiKey": "YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+## API 文档
+
+### 认证
+
+#### 用户登录
+```http
+POST /api/auth/user/login
+Content-Type: application/json
+
+{
+  "email": "user@example.com",
+  "apiKey": "your-api-key"
+}
+```
+
+#### 超级管理员登录
+```http
+POST /api/auth/admin/login
+Content-Type: application/json
+
+{
+  "username": "admin",
+  "password": "123456"
+}
+```
+
+### 用户管理
+
+```http
+GET /api/users
+Authorization: Bearer <token>
+```
+
+### 配置管理
+
+```http
+GET /api/configs
+POST /api/configs
+PUT /api/configs/:id
+DELETE /api/configs/:id
+Authorization: Bearer <token>
+```
+
+## 许可证
+
+MIT
+
+## 作者
+
+llj

package/dist/api/auth.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 认证 API
+ */
+import { Hono } from 'hono';
+export declare const authRouter: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+//# sourceMappingURL=auth.d.ts.map

package/dist/api/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/api/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAU5B,eAAO,MAAM,UAAU,4EAAa,CAAC"}

package/dist/api/auth.js

@@ -0,0 +1,111 @@
+/**
+ * 认证 API
+ */
+import { Hono } from 'hono';
+import { SignJWT } from 'jose';
+import { loginUser, loginAdmin, getUserById } from '../auth/index.js';
+import { authMiddleware, getCurrentUserId } from './middleware.js';
+import { report } from '../utils/telemetry.js';
+const JWT_SECRET = process.env.JWT_SECRET || 'your-secret-key-change-in-production';
+const secret = new TextEncoder().encode(JWT_SECRET);
+export const authRouter = new Hono();
+// 用户登录（邮箱 + API Key）
+authRouter.post('/user/login', async (c) => {
+    try {
+        const body = await c.req.json();
+        const { email, apiKey } = body;
+        if (!email || !apiKey) {
+            return c.json({ success: false, error: 'Email and API key are required' }, 400);
+        }
+        const user = await loginUser(email, apiKey);
+        if (!user) {
+            return c.json({ success: false, error: 'Invalid credentials' }, 401);
+        }
+        // 生成 JWT Token
+        const token = await new SignJWT({
+            userId: user.id,
+            email: user.email,
+            role: user.role,
+        })
+            .setProtectedHeader({ alg: 'HS256' })
+            .setIssuedAt()
+            .setExpirationTime('7d')
+            .sign(secret);
+        const response = {
+            token,
+            user: {
+                id: user.id,
+                email: user.email,
+                role: user.role,
+                createdAt: user.createdAt,
+                updatedAt: user.updatedAt,
+            },
+        };
+        // 上报用户登录统计
+        report('user_login', {
+            role: user.role,
+        }, user.id);
+        return c.json({ success: true, data: response });
+    }
+    catch (error) {
+        return c.json({ success: false, error: error.message }, 500);
+    }
+});
+// 超级管理员登录（用户名 + 密码）
+authRouter.post('/admin/login', async (c) => {
+    try {
+        const body = await c.req.json();
+        const { username, password } = body;
+        if (!username || !password) {
+            return c.json({ success: false, error: 'Username and password are required' }, 400);
+        }
+        const isValid = await loginAdmin(username, password);
+        if (!isValid) {
+            return c.json({ success: false, error: 'Invalid credentials' }, 401);
+        }
+        // 生成 JWT Token（超级管理员）
+        const token = await new SignJWT({
+            role: 'admin',
+            username,
+        })
+            .setProtectedHeader({ alg: 'HS256' })
+            .setIssuedAt()
+            .setExpirationTime('7d')
+            .sign(secret);
+        // 上报管理员登录统计（不传递用户ID，因为管理员没有用户ID）
+        report('admin_login', {
+            username,
+        });
+        return c.json({
+            success: true,
+            data: {
+                token,
+                role: 'admin',
+                username,
+            },
+        });
+    }
+    catch (error) {
+        return c.json({ success: false, error: error.message }, 500);
+    }
+});
+// 获取当前用户信息
+authRouter.get('/user/me', authMiddleware, async (c) => {
+    try {
+        const userId = getCurrentUserId(c);
+        if (!userId) {
+            return c.json({ success: false, error: 'User not found' }, 401);
+        }
+        const user = await getUserById(userId);
+        if (!user) {
+            return c.json({ success: false, error: 'User not found' }, 404);
+        }
+        // 返回用户信息（不包含 API Key）
+        const { apiKey: _omit, ...userWithoutKey } = user;
+        return c.json({ success: true, data: userWithoutKey });
+    }
+    catch (error) {
+        return c.json({ success: false, error: error.message }, 500);
+    }
+});
+//# sourceMappingURL=auth.js.map

package/dist/api/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/api/auth.ts"],"names":[],"mappings":"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"}

package/dist/api/configs.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP 配置管理 API
+ */
+import { Hono } from 'hono';
+export declare const configRouter: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+//# sourceMappingURL=configs.d.ts.map

package/dist/api/configs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configs.d.ts","sourceRoot":"","sources":["../../src/api/configs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAW5B,eAAO,MAAM,YAAY,4EAAa,CAAC"}