sufy-mcp-server 1.0.0__tar.gz

sufy_mcp_server-1.0.0/.env.example

@@ -0,0 +1,6 @@
+# S3/Sufy 认证信息
+SUFY_ACCESS_KEY=your_access_key
+SUFY_SECRET_KEY=your_secret_key
+SUFY_REGION_NAME=your_region  # eg:us-south-1
+SUFY_ENDPOINT_URL=endpoint_url  # eg:https://mos.us-south-1.sufybkt.com
+SUFY_BUCKETS=bucket1,bucket2,bucket3

sufy_mcp_server-1.0.0/.github/workflows/ruff.yml

@@ -0,0 +1,8 @@
+name: Ruff
+on: [push, pull_request]
+jobs:
+  ruff:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/ruff-action@v3

sufy_mcp_server-1.0.0/.gitignore

@@ -0,0 +1,13 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+.env
+
+test.py

sufy_mcp_server-1.0.0/.idea/.gitignore

@@ -0,0 +1,8 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

sufy_mcp_server-1.0.0/.idea/demo.iml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <excludeFolder url="file://$MODULE_DIR$/.venv" />
+    </content>
+    <orderEntry type="jdk" jdkName="Python 3.12 (sufy-mcp-server)" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

sufy_mcp_server-1.0.0/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

sufy_mcp_server-1.0.0/.idea/misc.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Black">
+    <option name="sdkName" value="Python 3.9 (mcp-server)" />
+  </component>
+  <component name="ProjectRootManager" version="2" project-jdk-name="Python 3.12 (sufy-mcp-server)" project-jdk-type="Python SDK" />
+</project>

sufy_mcp_server-1.0.0/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/demo.iml" filepath="$PROJECT_DIR$/.idea/demo.iml" />
+    </modules>
+  </component>
+</project>

sufy_mcp_server-1.0.0/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

sufy_mcp_server-1.0.0/.idea/workspace.xml

@@ -0,0 +1,208 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="fa567ce3-5664-44c9-99d5-2af592d41018" name="Changes" comment="" />
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="FileTemplateManagerImpl">
+    <option name="RECENT_TEMPLATES">
+      <list>
+        <option value="Python Script" />
+      </list>
+    </option>
+  </component>
+  <component name="Git.Settings">
+    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
+  </component>
+  <component name="ProjectColorInfo">{
+  &quot;associatedIndex&quot;: 4
+}</component>
+  <component name="ProjectId" id="2uFyAMrS01i95liKU4P48OfEkJj" />
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent"><![CDATA[{
+  "keyToString": {
+    "Python.client.executor": "Debug",
+    "Python.server (1).executor": "Debug",
+    "Python.server.executor": "Debug",
+    "Python.test.executor": "Debug",
+    "RunOnceActivity.ShowReadmeOnStart": "true",
+    "git-widget-placeholder": "main",
+    "node.js.detected.package.eslint": "true",
+    "node.js.detected.package.tslint": "true",
+    "node.js.selected.package.eslint": "(autodetect)",
+    "node.js.selected.package.tslint": "(autodetect)",
+    "nodejs_package_manager_path": "npm",
+    "settings.editor.selected.configurable": "com.jetbrains.python.configuration.PyActiveSdkModuleConfigurable",
+    "vue.rearranger.settings.migration": "true"
+  }
+}]]></component>
+  <component name="RecentsManager">
+    <key name="MoveFile.RECENT_KEYS">
+      <recent name="$PROJECT_DIR$/src" />
+      <recent name="$PROJECT_DIR$/docs" />
+      <recent name="$PROJECT_DIR$/mcp_server/biz/storage" />
+      <recent name="$PROJECT_DIR$/src/consts" />
+      <recent name="$PROJECT_DIR$/src/tools" />
+    </key>
+  </component>
+  <component name="RunManager" selected="Python.test">
+    <configuration name="client" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
+      <module name="demo" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <envs>
+        <env name="PYTHONUNBUFFERED" value="1" />
+      </envs>
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <EXTENSION ID="PythonCoverageRunConfigurationExtension" runner="coverage.py" />
+      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/client.py" />
+      <option name="PARAMETERS" value="" />
+      <option name="SHOW_COMMAND_LINE" value="false" />
+      <option name="EMULATE_TERMINAL" value="false" />
+      <option name="MODULE_MODE" value="false" />
+      <option name="REDIRECT_INPUT" value="false" />
+      <option name="INPUT_FILE" value="" />
+      <method v="2" />
+    </configuration>
+    <configuration name="server (1)" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
+      <module name="demo" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <envs>
+        <env name="PYTHONUNBUFFERED" value="1" />
+      </envs>
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/mcp_server" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <EXTENSION ID="PythonCoverageRunConfigurationExtension" runner="coverage.py" />
+      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/mcp_server/server.py" />
+      <option name="PARAMETERS" value="" />
+      <option name="SHOW_COMMAND_LINE" value="false" />
+      <option name="EMULATE_TERMINAL" value="false" />
+      <option name="MODULE_MODE" value="false" />
+      <option name="REDIRECT_INPUT" value="false" />
+      <option name="INPUT_FILE" value="" />
+      <method v="2" />
+    </configuration>
+    <configuration name="server" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
+      <module name="demo" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <envs>
+        <env name="PYTHONUNBUFFERED" value="1" />
+      </envs>
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/mcp" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <EXTENSION ID="PythonCoverageRunConfigurationExtension" runner="coverage.py" />
+      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/mcp/server.py" />
+      <option name="PARAMETERS" value="" />
+      <option name="SHOW_COMMAND_LINE" value="false" />
+      <option name="EMULATE_TERMINAL" value="false" />
+      <option name="MODULE_MODE" value="false" />
+      <option name="REDIRECT_INPUT" value="false" />
+      <option name="INPUT_FILE" value="" />
+      <method v="2" />
+    </configuration>
+    <configuration name="test" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
+      <module name="demo" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <envs>
+        <env name="PYTHONUNBUFFERED" value="1" />
+      </envs>
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/mcp_server" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <EXTENSION ID="PythonCoverageRunConfigurationExtension" runner="coverage.py" />
+      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/mcp_server/test.py" />
+      <option name="PARAMETERS" value="" />
+      <option name="SHOW_COMMAND_LINE" value="false" />
+      <option name="EMULATE_TERMINAL" value="false" />
+      <option name="MODULE_MODE" value="false" />
+      <option name="REDIRECT_INPUT" value="false" />
+      <option name="INPUT_FILE" value="" />
+      <method v="2" />
+    </configuration>
+    <recent_temporary>
+      <list>
+        <item itemvalue="Python.test" />
+        <item itemvalue="Python.server (1)" />
+        <item itemvalue="Python.server" />
+        <item itemvalue="Python.client" />
+      </list>
+    </recent_temporary>
+  </component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-js-predefined-d6986cc7102b-7c0b70fcd90d-JavaScript-PY-242.21829.153" />
+        <option value="bundled-python-sdk-464836ebc622-b74155a9e76b-com.jetbrains.pycharm.pro.sharedIndexes.bundled-PY-242.21829.153" />
+      </set>
+    </attachedChunks>
+  </component>
+  <component name="SpellCheckerSettings" RuntimeDictionaries="0" Folders="0" CustomDictionaries="0" DefaultDictionary="application-level" UseSingleDictionary="true" transferred="true" />
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="Default task">
+      <changelist id="fa567ce3-5664-44c9-99d5-2af592d41018" name="Changes" comment="" />
+      <created>1741858472943</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1741858472943</updated>
+      <workItem from="1741858474073" duration="4607000" />
+      <workItem from="1741867136217" duration="599000" />
+      <workItem from="1741934215275" duration="9489000" />
+      <workItem from="1741945627423" duration="2208000" />
+      <workItem from="1741948344370" duration="116000" />
+      <workItem from="1741948472546" duration="5297000" />
+      <workItem from="1742953250766" duration="10839000" />
+      <workItem from="1742970629916" duration="4121000" />
+      <workItem from="1742983816785" duration="8358000" />
+      <workItem from="1743405438634" duration="734000" />
+      <workItem from="1743406257711" duration="126000" />
+      <workItem from="1743564699701" duration="7516000" />
+      <workItem from="1743577301559" duration="31287000" />
+      <workItem from="1743669402740" duration="79274000" />
+      <workItem from="1744194299783" duration="717000" />
+      <workItem from="1744255142075" duration="11042000" />
+      <workItem from="1744275969330" duration="1857000" />
+      <workItem from="1744277833149" duration="22359000" />
+      <workItem from="1744595899820" duration="38208000" />
+    </task>
+    <servers />
+  </component>
+  <component name="TypeScriptGeneratedFilesManager">
+    <option name="version" value="3" />
+  </component>
+  <component name="com.intellij.coverage.CoverageDataManagerImpl">
+    <SUITE FILE_PATH="coverage/demo$server__1_.coverage" NAME="server (1) Coverage Results" MODIFIED="1741949177226" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$/mcp_server" />
+    <SUITE FILE_PATH="coverage/qiniu_mcp_server$test.coverage" NAME="test Coverage Results" MODIFIED="1744275627541" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$/mcp_server" />
+    <SUITE FILE_PATH="coverage/demo$server.coverage" NAME="server Coverage Results" MODIFIED="1741948818126" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$/mcp" />
+    <SUITE FILE_PATH="coverage/qiniu_mcp$server__1_.coverage" NAME="server (1) Coverage Results" MODIFIED="1742969398555" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$/mcp_server" />
+    <SUITE FILE_PATH="coverage/demo$client.coverage" NAME="client Coverage Results" MODIFIED="1741864776694" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$" />
+    <SUITE FILE_PATH="coverage/qiniu_mcp_server$server__1_.coverage" NAME="server (1) Coverage Results" MODIFIED="1743660431369" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$/mcp_server" />
+  </component>
+</project>

sufy_mcp_server-1.0.0/.python-version

@@ -0,0 +1 @@
+3.12

sufy_mcp_server-1.0.0/CHANGELOG.md

@@ -0,0 +1,3 @@
+# v1.0.0
+
+- 支持访问存储、多媒体服务

sufy_mcp_server-1.0.0/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Sufy
+
+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.

sufy_mcp_server-1.0.0/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: sufy-mcp-server
+Version: 1.0.0
+Summary: A MCP server project of Sufy.
+License-File: LICENSE.txt
+Requires-Python: >=3.12
+Requires-Dist: aioboto3>=13.2.0
+Requires-Dist: fastjsonschema>=2.21.1
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: mcp[cli]>=1.0.0
+Requires-Dist: openai>=1.66.3
+Requires-Dist: pip>=25.0.1
+Requires-Dist: python-dotenv>=1.0.1

sufy_mcp_server-1.0.0/README.md

@@ -0,0 +1,139 @@
+# Sufy MCP Server
+
+[Chinese Documentation](README_zh.md) | [English Documentation](README.md)
+
+## Overview
+
+The Model Context Protocol (MCP) Server built on Sufy products allows users to access Sufy services through this MCP Server within the context of AI large model clients.
+
+## Environment Requirements
+
+• Python 3.12 or higher
+• uv package manager
+
+If you haven't installed uv yet, you can install it with the following command:
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+## Usage in Cline
+
+Steps:
+
+1. Install the Cline plugin in VSCode (the Cline icon will appear in the sidebar after installation)
+2. Configure the Large Model
+3. Configure Sufy MCP
+    1. Click the Cline icon to enter the plugin interface and select the MCP Server module
+    2. Choose "Installed", click "Advanced MCP Settings", and configure using the following template:
+   ```json
+   {
+     "mcpServers": {
+       "Sufy": {
+         "command": "uvx",
+         "args": [
+           "sufy-mcp-server"
+         ],
+         "env": {
+           "SUFY_ACCESS_KEY": "YOUR_ACCESS_KEY",
+           "SUFY_SECRET_KEY": "YOUR_SECRET_KEY",
+           "SUFY_REGION_NAME": "YOUR_REGION_NAME",
+           "SUFY_ENDPOINT_URL": "YOUR_ENDPOINT_URL",
+           "SUFY_BUCKETS": "YOUR_BUCKET_A,YOUR_BUCKET_B"
+        },
+         "disabled": false
+       }
+     }
+   }
+   ```
+    3. Toggle the connection switch for Sufy MCP Server to establish connection
+4. Create a chat window in Cline to interact with AI using sufy-mcp-server. Example prompts:
+    ◦ List Sufy resource information
+    ◦ List all Buckets in Sufy
+    ◦ List files in Sufy's xxx Bucket
+    ◦ Read content of yyy file in Sufy's xxx Bucket
+    ◦ Resize image yyy in Sufy's xxx Bucket by 20%
+
+Note: When creating an MCP Server in Cline, you can directly use the above configuration.
+
+## Development
+
+1. Clone the repository:
+```bash
+git clone git@github.com:sufy/sufy-mcp-server.git
+cd sufy-mcp-server
+```
+
+2. Create and activate virtual environment:
+```bash
+uv venv
+source .venv/bin/activate  # Linux/macOS
+# or
+.venv\Scripts\activate  # Windows
+```
+
+3. Install dependencies:
+```bash
+uv pip install -e .
+```
+
+4. Configuration
+
+Copy environment template:
+```bash
+cp .env.example .env
+```
+
+Edit `.env` file with these parameters:
+```bash
+# S3/Sufy credentials
+SUFY_ACCESS_KEY=your_access_key
+SUFY_SECRET_KEY=your_secret_key
+
+# Region info
+SUFY_REGION_NAME=your_region
+SUFY_ENDPOINT_URL=endpoint_url # eg:https://s3.your_region.sufycs.com
+
+# Configure buckets (comma-separated, max 20 recommended)
+SUFY_BUCKETS=bucket1,bucket2,bucket3
+```
+
+For feature extensions:
+1. Create a new business package directory under `core` (e.g., storage)
+2. Implement features in the package directory
+3. Register tools/resources via `load()` function in the package's `__init__.py`
+4. Call the load function in `core/__init__.py` to complete registration
+
+Directory structure:
+```shell
+core
+├── __init__.py # Load business tools/resources
+└── storage # Storage service
+    ├── __init__.py # Load storage tools/resources
+    ├── resource.py # Storage resources
+    ├── storage.py # Storage utilities
+    └── tools.py # Storage tools
+```
+
+## Testing
+
+### Using Model Control Protocol Inspector
+
+Recommended tool: [Model Control Protocol Inspector](https://github.com/modelcontextprotocol/inspector)
+
+```shell
+# Requires node v22.4.0
+npx @modelcontextprotocol/inspector uv --directory . run sufy-mcp-server
+```
+
+### Local MCP Server Examples
+
+1. Start in stdio mode (default):
+```bash
+uv --directory . run sufy-mcp-server
+```
+
+2. Start in SSE mode (for web applications):
+```bash
+uv --directory . run sufy-mcp-server --transport sse --port 8000
+```

sufy_mcp_server-1.0.0/README_zh.md

@@ -0,0 +1,146 @@
+# Sufy MCP Server
+
+[中文文档](README_zh.md) | [英文文档](README.md)
+
+## 概述
+
+基于 Sufy 产品构建的 Model Context Protocol (MCP) Server，支持用户在 AI 大模型客户端的上下文中通过该 MCP
+Server 来访问 Sufy 服务。
+
+## 环境要求
+
+- Python 3.12 或更高版本
+- uv 包管理器
+
+如果还没有安装 uv，可以使用以下命令安装：
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+## 在 Cline 中使用：
+
+步骤：
+
+1. 在 vscode 下载 Cline 插件（下载后 Cline 插件后在侧边栏会增加 Cline 的图标）
+2. 配置大模型
+3. 配置 Sufy MCP
+    1. 点击 Cline 图标进入 Cline 插件，选择 MCP Server 模块
+    2. 选择 installed，点击 Advanced MCP Settings 配置 MCP Server，参考下面配置信息
+   ```
+   {
+     "mcpServers": {
+       "Sufy": {
+         "command": "uvx",
+         "args": [
+           "sufy-mcp-server"
+         ],
+         "env": {
+           "SUFY_ACCESS_KEY": "YOUR_ACCESS_KEY",
+           "SUFY_SECRET_KEY": "YOUR_SECRET_KEY",
+           "SUFY_REGION_NAME": "YOUR_REGION_NAME",
+           "SUFY_ENDPOINT_URL": "YOUR_ENDPOINT_URL",
+           "SUFY_BUCKETS": "YOUR_BUCKET_A,YOUR_BUCKET_B"
+        },
+         "disabled": false
+       }
+     }
+   }
+   ```
+    3. 点击 Sufy MCP Server 的链接开关进行连接
+4. 在 Cline 中创建一个聊天窗口，此时我们可以和 AI 进行交互来使用 sufy-mcp-server ，下面给出几个示例：
+    - 列举 Sufy 的资源信息
+    - 列举 Sufy 中所有的 Bucket
+    - 列举 Sufy 中 xxx Bucket 的文件
+    - 读取 Sufy xxx Bucket 中 yyy 的文件内容
+    - 对 Sufy xxx Bucket 中 yyy 的图片缩小20%
+
+注：cursor 中创建 MCP Server 可以直接使用上述配置
+
+
+## 开发
+1. 克隆仓库：
+
+```bash
+# 克隆项目并进入目录
+git clone git@github.com:sufy/sufy-mcp-server.git
+cd sufy-mcp-server
+```
+
+2. 创建并激活虚拟环境：
+
+```bash
+uv venv
+source .venv/bin/activate  # Linux/macOS
+# 或
+.venv\Scripts\activate  # Windows
+```
+
+3. 安装依赖：
+
+```bash
+uv pip install -e .
+```
+
+4. 配置
+
+复制环境变量模板：
+```bash
+cp .env.example .env
+```
+
+编辑 `.env` 文件，配置以下参数：
+```bash
+# S3/Sufy 认证信息
+SUFY_ACCESS_KEY=your_access_key
+SUFY_SECRET_KEY=your_secret_key
+
+# 区域信息
+SUFY_REGION_NAME=your_region
+SUFY_ENDPOINT_URL=endpoint_url # eg:https://s3.your_region.sufycs.com
+
+# 配置 bucket，多个 bucket 使用逗号隔开，建议最多配置 20 个 bucket
+SUFY_BUCKETS=bucket1,bucket2,bucket3
+```
+
+扩展功能，首先在 core 目录下新增一个业务包目录（eg: 存储 -> storage），在此业务包目录下完成功能拓展。
+在业务包目录下的 `__init__.py` 文件中定义 load 函数用于注册业务工具或者资源，最后在 `core` 目录下的 `__init__.py`
+中调用此 load 函数完成工具或资源的注册。
+
+```shell
+core
+├── __init__.py # 各个业务工具或者资源加载
+└── storage # 存储业务目录
+    ├── __init__.py # 加载存储工具或者资源
+    ├── resource.py # 存储资源扩展
+    ├── storage.py # 存储工具类
+    └── tools.py # 存储工具扩展
+```
+
+## 测试
+
+### 使用 Model Control Protocol Inspector 测试
+
+强烈推荐使用 [Model Control Protocol Inspector](https://github.com/modelcontextprotocol/inspector) 进行测试。
+
+```shell
+# node 版本为：v22.4.0
+npx @modelcontextprotocol/inspector uv --directory . run sufy-mcp-server
+```
+
+### 本地启动 MCP Server 示例
+
+1. 使用标准输入输出（stdio）模式启动（默认）：
+
+```bash
+uv --directory . run sufy-mcp-server
+```
+
+2. 使用 SSE 模式启动（用于 Web 应用）：
+
+```bash
+uv --directory . run sufy-mcp-server --transport sse --port 8000
+```
+
+
+

sufy_mcp_server-1.0.0/pyproject.toml

@@ -0,0 +1,24 @@
+[project]
+name = "sufy-mcp-server"
+version = "1.0.0"
+description = "A MCP server project of Sufy."
+requires-python = ">=3.12"
+dependencies = [
+    "aioboto3>=13.2.0",
+    "fastjsonschema>=2.21.1",
+    "httpx>=0.28.1",
+    "mcp[cli]>=1.0.0",
+    "openai>=1.66.3",
+    "pip>=25.0.1",
+    "python-dotenv>=1.0.1",
+]
+
+[build-system]
+requires = [ "hatchling",]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mcp_server"]
+
+[project.scripts]
+sufy-mcp-server = "mcp_server:main"

sufy_mcp_server-1.0.0/src/mcp_server/__init__.py

@@ -0,0 +1,11 @@
+import logging
+
+from .consts import consts
+from .server import main
+
+# Configure logging
+logging.basicConfig(level=logging.ERROR)
+logger = logging.getLogger(consts.LOGGER_NAME)
+logger.info("Initializing MCP server package")
+
+__all__ = ["main"]