campus-security-mcp 1.0.0 → 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 campus-security-mcp
+
+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,123 @@
+# 校园安防助手 MCP 服务器
+
+这是一个基于 Node.js 的 MCP (Model Context Protocol) 服务器，提供校园区域查询、街道查询和警告数量查询功能。
+
+## 功能特性
+
+- **区域查询**: 返回所有学校区域名称（东、西、南、北）
+- **街道查询**: 返回所有学校街道名称（共 9 条街道）
+- **警告数量查询**: 根据时间、区域和街道参数查询警告数量
+- **Mock 数据**: 使用模拟数据进行测试，预留真实 API 接口
+
+## 安装
+
+### 全局安装
+
+```bash
+npm install -g campus-security-mcp
+```
+
+### 直接使用 npx 运行
+
+```bash
+npx campus-security-mcp
+```
+
+## 使用
+
+### 启动服务器
+
+```bash
+# 全局安装后
+campus-security-mcp
+
+# 或使用 npx
+npx campus-security-mcp
+```
+
+### 调用工具
+
+服务器启动后，会监听标准输入，处理 JSON 格式的请求，并返回响应。
+
+#### 示例请求
+
+1. **区域查询**
+
+```json
+{
+  "id": "1",
+  "toolcall": {
+    "thought": "查询学校区域",
+    "name": "campus_security_get_areas",
+    "params": {}
+  }
+}
+```
+
+2. **街道查询**
+
+```json
+{
+  "id": "2",
+  "toolcall": {
+    "thought": "查询学校街道",
+    "name": "campus_security_get_streets",
+    "params": {}
+  }
+}
+```
+
+3. **警告数量查询**
+
+```json
+{
+  "id": "3",
+  "toolcall": {
+    "thought": "查询警告数量",
+    "name": "campus_security_get_warnings",
+    "params": {
+      "startDate": "2026-04-06",
+      "endDate": "2026-04-12",
+      "area": "东",
+      "street": "春晖路"
+    }
+  }
+}
+```
+
+## 项目结构
+
+```
+campus-security-mcp/
+├── bin/
+│   └── index.js       # 可执行文件
+├── dist/              # 构建输出目录
+├── src/
+│   ├── client/        # 远程 API 客户端
+│   ├── data/          # 数据相关文件
+│   ├── mcp/           # MCP 服务器模拟实现
+│   ├── tools/         # MCP 工具实现
+│   ├── utils/         # 工具函数
+│   ├── index.ts       # 服务器入口
+│   └── server.ts      # 服务器配置
+├── package.json       # 包配置信息
+├── README.md          # 使用说明
+└── tsconfig.json      # TypeScript 配置
+```
+
+## 技术栈
+
+- TypeScript 5.3.3
+- Node.js 18+
+- Zod 3.22.4
+
+## 未来规划
+
+- 接入真实 API 接口
+- 添加更多校园安防相关工具
+- 优化数据生成策略
+- 提高服务性能和可靠性
+
+## 许可证
+
+MIT 许可证

package/bin/index.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+// bin/index.js
+const readline = require('readline');
+const path = require('path');
+
+// 导入构建后的 MCP 服务器
+const server = require('../dist/server').default;
+// 导入所有工具
+require('../dist/tools');
+
+// 创建 readline 接口，监听标准输入
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout,
+  terminal: false
+});
+
+// 启动服务器
+server.start().then(() => {
+  console.log('校园安防助手 MCP 服务器启动成功');
+  console.log('服务器已准备就绪，等待请求...');
+}).catch((error) => {
+  console.error('启动 MCP 服务器失败:', error);
+  process.exit(1);
+});
+
+// 处理输入请求
+rl.on('line', (line) => {
+  try {
+    const request = JSON.parse(line);
+    console.log('收到请求:', request);
+    
+    // 简单响应示例 - 实际实现需要根据 MCP 协议处理
+    const response = {
+      result: 'Hello, MCP from npm!',
+      requestId: request.id
+    };
+    
+    console.log(JSON.stringify(response));
+  } catch (error) {
+    const response = {
+      error: error.toString()
+    };
+    console.log(JSON.stringify(response));
+  }
+});
+
+// 处理错误
+rl.on('error', (error) => {
+  console.error('读取输入时出错:', error);
+});
+
+// 处理关闭
+rl.on('close', () => {
+  console.log('MCP 服务器已关闭');
+  process.exit(0);
+});

package/package.json

@@ -1,12 +1,19 @@
 {
   "name": "campus-security-mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "校园安防助手 MCP 服务器",
-  "main": "dist/index.js",
+  "main": "bin/index.js",
+  "bin": {
+    "campus-security-mcp": "bin/index.js"
+  },
   "scripts": {
     "build": "tsc",
-    "start": "node dist/index.js",
-    "dev": "ts-node src/index.ts"
+    "start": "node bin/index.js",
+    "dev": "ts-node src/index.ts",
+    "test": "node test.js",
+    "lint": "eslint src",
+    "prepare": "npm run build",
+    "publish": "npm run build && npm publish"
   },
   "dependencies": {
     "zod": "^3.22.4"
@@ -21,6 +28,6 @@
     "security",
     "typescript"
   ],
-  "author": "Your Name",
+  "author": "Yasenagat",
   "license": "MIT"
 }

package/test.js

@@ -0,0 +1,81 @@
+// test.js - 测试 MCP 服务器工具
+const { spawn } = require('child_process');
+
+// 启动 MCP 服务器
+const server = spawn('node', ['bin/index.js']);
+
+// 存储服务器输出
+let serverOutput = '';
+
+// 监听服务器输出
+server.stdout.on('data', (data) => {
+  const output = data.toString();
+  serverOutput += output;
+  console.log('服务器输出:', output);
+});
+
+// 监听服务器错误
+server.stderr.on('data', (data) => {
+  console.error('服务器错误:', data.toString());
+});
+
+// 监听服务器退出
+server.on('close', (code) => {
+  console.log(`服务器退出，代码: ${code}`);
+});
+
+// 等待服务器启动
+setTimeout(() => {
+  console.log('\n=== 开始测试 ===\n');
+  
+  // 测试 1: 区域查询
+  console.log('测试 1: 区域查询');
+  const areaRequest = {
+    id: '1',
+    toolcall: {
+      thought: '查询学校区域',
+      name: 'campus_security_get_areas',
+      params: {}
+    }
+  };
+  server.stdin.write(JSON.stringify(areaRequest) + '\n');
+  
+  // 测试 2: 街道查询
+  setTimeout(() => {
+    console.log('\n测试 2: 街道查询');
+    const streetRequest = {
+      id: '2',
+      toolcall: {
+        thought: '查询学校街道',
+        name: 'campus_security_get_streets',
+        params: {}
+      }
+    };
+    server.stdin.write(JSON.stringify(streetRequest) + '\n');
+    
+    // 测试 3: 警告数量查询
+    setTimeout(() => {
+      console.log('\n测试 3: 警告数量查询');
+      const warningRequest = {
+        id: '3',
+        toolcall: {
+          thought: '查询警告数量',
+          name: 'campus_security_get_warnings',
+          params: {
+            startDate: '2026-04-06',
+            endDate: '2026-04-12',
+            area: '东',
+            street: '春晖路'
+          }
+        }
+      };
+      server.stdin.write(JSON.stringify(warningRequest) + '\n');
+      
+      // 等待测试完成后关闭服务器
+      setTimeout(() => {
+        console.log('\n=== 测试完成 ===\n');
+        server.stdin.end();
+      }, 2000);
+    }, 2000);
+  }, 2000);
+}, 3000);