@atengk/mcp-server-s3 1.0.0 → 1.1.0

package/README.md

@@ -390,14 +390,18 @@ npx -y @atengk/mcp-server-s3 --transport sse --port 8000 --api-key secret-token-
 
 ### 1. 使用 Docker Compose 一键启动微服务集群
 
+`docker-compose.yaml` 默认直接拉取 GitHub Packages (GHCR) 发布的预编译多架构镜像（`ghcr.io/atengk/mcp-server-s3:latest`），**无需本地安装 Node/pnpm 或进行耗时编译**，甚至仅需单独下载单份 `docker-compose.yaml` 即可秒级拉起完整的 MinIO + S3 MCP 集群：
+
 ```bash
-# 后台拉起微服务集群 (MinIO + S3 MCP)
+# 后台拉起微服务集群 (MinIO + 预编译 S3 MCP)
 docker compose up -d
 
 # 检查服务就绪探针 (健康检查公开免鉴权)
 curl http://localhost:8000/health
 ```
 
+> 💡 **进阶提示**：如需锁定特定版本，可运行 `MCP_S3_IMAGE_TAG=v1.0.1 docker compose up -d`；如需基于本地源码二次开发，仅需按 `docker-compose.yaml` 中提示解除 `build` 注释即可。
+
 ### 2. 远程 HTTP SSE 鉴权接入规范
 
 当设置了 `MCP_S3_API_KEY=your-secret-token` 时，服务将自动启用 CORS 与双栈校验机制：

package/dist/index.d.ts

@@ -1379,6 +1379,7 @@ declare function resolveConfigWithCli(args?: string[], env?: NodeJS.ProcessEnv):
  * @since 2026-10-04
  */
 
+declare const SERVER_VERSION = "1.1.0";
 /**
  * 组装并配置 MCP Server 实例
  *
@@ -1400,4 +1401,4 @@ declare function runServer(customConfig?: AppConfig, argv?: string[]): Promise<{
     close?: () => Promise<void>;
 }>;
 
-export { type AppConfig, AppConfigSchema, type BucketItem, BusinessError, type CommonPrefixItem, type ConnectivityProbeResult, ConnectivityProbeResultSchema, type ContentTruncationResult, ContentTruncator, type ContentTruncatorOptions, type CopyObjectInput, CopyObjectSchema, type CreateBucketInput, CreateBucketSchema, DEFAULT_MAX_READ_BYTES, type DeleteBucketInput, DeleteBucketSchema, type DeleteObjectInput, DeleteObjectSchema, type DeleteObjectsBatchInput, DeleteObjectsBatchSchema, type DeleteObjectsByPrefixInput, DeleteObjectsByPrefixSchema, type DownloadFileInput, DownloadFileSchema, type ErrorResult, ErrorResultSchema, type GetBucketLocationInput, GetBucketLocationSchema, type GetObjectTagsInput, GetObjectTagsSchema, type GetPresignedUrlInput, GetPresignedUrlSchema, type ListBucketsInput, ListBucketsSchema, type ListObjectsInput, type ListObjectsResult, ListObjectsSchema, MULTIPART_PART_SIZE_BYTES, MULTIPART_QUEUE_SIZE, MULTIPART_UPLOAD_THRESHOLD_BYTES, type McpServerFactory, type MoveObjectInput, MoveObjectSchema, type ObjectMetadata, type ObjectTags, PrefixDeletionGuard, type PresignedUrlResult, type PutObjectTextInput, PutObjectTextSchema, type RangeReadResult, type ReadObjectRangeInput, ReadObjectRangeSchema, type ReadObjectTextInput, type ReadObjectTextResult, ReadObjectTextSchema, ReadOnlyGuard, type S3ClientConfig, S3ClientConfigSchema, type S3CredentialsConfig, S3CredentialsConfigSchema, type S3ObjectItem, type S3PingInput, S3PingSchema, type SSEServerInstance, SandboxGuard, type SearchObjectsInput, SearchObjectsSchema, type SecurityCheckResult, SecurityError, type SecurityErrorCode, SecurityErrorCodeSchema, type SetObjectTagsInput, SetObjectTagsSchema, type StatObjectInput, StatObjectSchema, type TagItem, type TransportMode, TransportModeSchema, type UploadFileInput, UploadFileSchema, copyObject, createBucket, createMCPServer, createS3Client, deleteBucket, deleteObject, deleteObjectsBatch, deleteObjectsByPrefix, downloadFile, executeS3Ping, findSafeUtf8CutPoint, getBucketLocation, getEnvValue, getObjectTags, getPresignedUrl, getS3Client, getS3ClientConfig, listBuckets, listObjects, maskAccessKey, maskSensitiveConfig, moveObject, parseBoolean, parseEnv, parseNumber, parsePort, parsePositiveInt, printHelp, putObjectText, readObjectRange, readObjectText, resetS3Client, resolveBucket, resolveConfigWithCli, runServer, searchObjects, setObjectTags, startSSEServer, statObject, uploadFile };
+export { type AppConfig, AppConfigSchema, type BucketItem, BusinessError, type CommonPrefixItem, type ConnectivityProbeResult, ConnectivityProbeResultSchema, type ContentTruncationResult, ContentTruncator, type ContentTruncatorOptions, type CopyObjectInput, CopyObjectSchema, type CreateBucketInput, CreateBucketSchema, DEFAULT_MAX_READ_BYTES, type DeleteBucketInput, DeleteBucketSchema, type DeleteObjectInput, DeleteObjectSchema, type DeleteObjectsBatchInput, DeleteObjectsBatchSchema, type DeleteObjectsByPrefixInput, DeleteObjectsByPrefixSchema, type DownloadFileInput, DownloadFileSchema, type ErrorResult, ErrorResultSchema, type GetBucketLocationInput, GetBucketLocationSchema, type GetObjectTagsInput, GetObjectTagsSchema, type GetPresignedUrlInput, GetPresignedUrlSchema, type ListBucketsInput, ListBucketsSchema, type ListObjectsInput, type ListObjectsResult, ListObjectsSchema, MULTIPART_PART_SIZE_BYTES, MULTIPART_QUEUE_SIZE, MULTIPART_UPLOAD_THRESHOLD_BYTES, type McpServerFactory, type MoveObjectInput, MoveObjectSchema, type ObjectMetadata, type ObjectTags, PrefixDeletionGuard, type PresignedUrlResult, type PutObjectTextInput, PutObjectTextSchema, type RangeReadResult, type ReadObjectRangeInput, ReadObjectRangeSchema, type ReadObjectTextInput, type ReadObjectTextResult, ReadObjectTextSchema, ReadOnlyGuard, type S3ClientConfig, S3ClientConfigSchema, type S3CredentialsConfig, S3CredentialsConfigSchema, type S3ObjectItem, type S3PingInput, S3PingSchema, SERVER_VERSION, type SSEServerInstance, SandboxGuard, type SearchObjectsInput, SearchObjectsSchema, type SecurityCheckResult, SecurityError, type SecurityErrorCode, SecurityErrorCodeSchema, type SetObjectTagsInput, SetObjectTagsSchema, type StatObjectInput, StatObjectSchema, type TagItem, type TransportMode, TransportModeSchema, type UploadFileInput, UploadFileSchema, copyObject, createBucket, createMCPServer, createS3Client, deleteBucket, deleteObject, deleteObjectsBatch, deleteObjectsByPrefix, downloadFile, executeS3Ping, findSafeUtf8CutPoint, getBucketLocation, getEnvValue, getObjectTags, getPresignedUrl, getS3Client, getS3ClientConfig, listBuckets, listObjects, maskAccessKey, maskSensitiveConfig, moveObject, parseBoolean, parseEnv, parseNumber, parsePort, parsePositiveInt, printHelp, putObjectText, readObjectRange, readObjectText, resetS3Client, resolveBucket, resolveConfigWithCli, runServer, searchObjects, setObjectTags, startSSEServer, statObject, uploadFile };

package/dist/index.js

@@ -60807,10 +60807,11 @@ function wrapToolHandler(handler) {
     }
   };
 }
+var SERVER_VERSION = "1.1.0";
 function createMCPServer(config2 = parseEnv(), customClient) {
   const server = new McpServer({
     name: "mcp-server-s3",
-    version: "1.0.0"
+    version: SERVER_VERSION
   });
   const client = customClient ?? getS3Client(config2);
   const readOnlyGuard = new ReadOnlyGuard(config2.readOnly);
@@ -61033,7 +61034,8 @@ async function runServer(customConfig, argv) {
       process.exit(0);
     }
     if (isVersion) {
-      process.stdout.write("1.0.0\n");
+      process.stdout.write(`${SERVER_VERSION}
+`);
       process.exit(0);
     }
     config2 = resolvedConfig;
@@ -61106,6 +61108,7 @@ export {
   S3ClientConfigSchema,
   S3CredentialsConfigSchema,
   S3PingSchema,
+  SERVER_VERSION,
   SandboxGuard,
   SearchObjectsSchema,
   SecurityError,