mapbox-create-map-mcp 1.1.0 → 1.2.1

package/README.md

@@ -8,7 +8,42 @@
 npm install mapbox-create-map-mcp
 ```
 
-## 使用方法
+## MCP 服务使用
+
+### 直接启动
+
+```bash
+npx mapbox-create-map-mcp
+```
+
+### MCP 客户端配置
+
+在 MCP 客户端（如 Claude Desktop、Cursor 等）的配置文件中添加：
+
+```json
+{
+  "mcpServers": {
+    "mapbox-createmap": {
+      "command": "npx",
+      "args": ["mapbox-create-map-mcp"]
+    }
+  }
+}
+```
+
+### MCP 工具
+
+**CreateMap** - 根据配置生成地图图层配置信息
+
+输入参数：
+- `title` (string, 必需): 地图标题
+- `description` (string, 必需): 地图描述
+- `layers` (array, 必需): 图层配置数组
+- `baseStyle` (string, 可选): 底图样式
+- `center` (array, 可选): 中心点 [经度, 纬度]
+- `zoom` (number, 可选): 缩放级别
+
+## JavaScript 库使用
 
 ### 基本使用
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mapbox-create-map-mcp",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "A Mapbox-based MCP tool for creating geographic data visualizations",
   "main": "dist/index.js",
   "module": "src/index.js",

package/src/server.js

@@ -62,6 +62,12 @@ class McpServer {
   async handleRequest(request) {
     const { id, method, params } = request;
 
+    // 通知类型的消息不需要返回响应
+    if (method && method.startsWith('notifications/')) {
+      // 处理通知，不返回任何内容
+      return;
+    }
+
     try {
       let result;
 
@@ -82,6 +88,10 @@ class McpServer {
           result = this.handleResourcesList();
           break;
 
+        case 'ping':
+          result = {};
+          break;
+
         default:
           this.sendError(-32601, `Method not found: ${method}`, id);
           return;
@@ -114,11 +124,44 @@ class McpServer {
     const metadata = this.createMap.metadata;
     const layerMetadata = this.createMap.layerMetadata;
 
+    // 合并所有图层类型的配置属性
+    const allConfigProperties = {};
+    
+    // point 属性
+    for (const key in layerMetadata.point) {
+      const prop = layerMetadata.point[key];
+      allConfigProperties[key] = {
+        type: prop.type,
+        description: `[point图层] ${prop.description}`
+      };
+      if (prop.default !== undefined) allConfigProperties[key].default = prop.default;
+    }
+    
+    // linestring 属性
+    for (const key in layerMetadata.linestring) {
+      const prop = layerMetadata.linestring[key];
+      allConfigProperties[key] = {
+        type: prop.type,
+        description: `[linestring图层] ${prop.description}`
+      };
+      if (prop.default !== undefined) allConfigProperties[key].default = prop.default;
+    }
+    
+    // polygon 属性
+    for (const key in layerMetadata.polygon) {
+      const prop = layerMetadata.polygon[key];
+      allConfigProperties[key] = {
+        type: prop.type,
+        description: `[polygon图层] ${prop.description}`
+      };
+      if (prop.default !== undefined) allConfigProperties[key].default = prop.default;
+    }
+
     return {
       tools: [
         {
           name: 'CreateMap',
-          description: '根据配置生成地图图层配置信息，返回FeatureCollection格式的结果用于渲染',
+          description: '根据配置生成地图图层配置信息，返回FeatureCollection格式的结果用于渲染。图层类型支持point(点)、linestring(线)、polygon(面)三种。',
           inputSchema: {
             type: 'object',
             properties: {
@@ -133,23 +176,20 @@ class McpServer {
               baseStyle: {
                 type: 'string',
                 enum: metadata.baseStyle.enum,
-                default: metadata.baseStyle.default,
                 description: metadata.baseStyle.description
               },
               center: {
                 type: 'array',
                 items: { type: 'number' },
-                default: metadata.center.default,
                 description: metadata.center.description
               },
               zoom: {
                 type: 'number',
-                default: metadata.zoom.default,
                 description: metadata.zoom.description
               },
               layers: {
                 type: 'array',
-                description: metadata.layers.description,
+                description: '图层配置数组。每个图层需要id和type，type决定了config中可用的属性：point类型用circle-*属性，lingestring类型用line-*属性，polygon类型用fill-*属性',
                 items: {
                   type: 'object',
                   properties: {
@@ -157,27 +197,14 @@ class McpServer {
                     type: {
                       type: 'string',
                       enum: ['point', 'linestring', 'polygon'],
-                      description: '图层类型'
+                      description: '图层类型: point(点,使用circle-*属性), linestring(线,使用line-*属性), polygon(面,使用fill-*属性)'
                     },
                     data: { type: 'object', description: 'GeoJSON格式的地理数据' },
-                    fileUrl: { type: 'string', description: '数据文件URL' },
+                    fileUrl: { type: 'string', description: '数据URL地址' },
                     config: {
                       type: 'object',
-                      description: '图层样式配置，属性取决于type字段的值',
-                      propertiesByType: {
-                        point: {
-                          description: '当type="point"时，config使用以下属性（对应Mapbox circle图层）',
-                          properties: this.formatProperties(layerMetadata.point)
-                        },
-                        linestring: {
-                          description: '当type="linestring"时，config使用以下属性（对应Mapbox line图层）',
-                          properties: this.formatProperties(layerMetadata.linestring)
-                        },
-                        polygon: {
-                          description: '当type="polygon"时，config使用以下属性（对应Mapbox fill图层）',
-                          properties: this.formatProperties(layerMetadata.polygon)
-                        }
-                      }
+                      description: '图层样式配置，根据type选择对应属性: point用circle-*、linestring用line-*、polygon用fill-*',
+                      properties: allConfigProperties
                     }
                   },
                   required: ['id', 'type']