fangcloud-mcp 0.1.5__py3-none-any.whl → 0.1.7__py3-none-any.whl

{fangcloud → fangcloud_mcp}/__init__.py

@@ -2,8 +2,6 @@
 FangCloud MCP - Model Context Protocol (MCP) 服务器实现，提供与 FangCloud 云存储服务的集成
 """
 
-__version__ = "0.1.4"
-
 from .fangcloud import main
 from .fangcloud_api import FangcloudAPI
 

{fangcloud → fangcloud_mcp}/fangcloud.py

@@ -64,7 +64,7 @@ async def get_folder_info(folder_id: str) -> Dict[str, Any]:
     Get folder information
     
     Args:
-        folder_id: Folder ID
+        folder_id: Folder ID (value 0 represents the root directory ID of personal space)
         
     Returns:
         Folder information (JSON format) or error message
@@ -92,7 +92,7 @@ async def create_folder(name: str, parent_id: str,
     
     Args:
         name: Folder name (1-222 characters, cannot contain / ? : * " > <)
-        parent_id: Parent folder ID
+        parent_id: Parent folder ID (value 0 represents the root directory ID of personal space)
         target_space_type: Space type - "department" or "personal" (optional, effective when parent_id is 0)
         target_space_id: Space ID (required when target_space_type is "department")
         
@@ -138,7 +138,7 @@ async def upload_file(parent_folder_id: str, local_file_path: str) -> Dict[str,
     Upload file to FangCloud
     
     Args:
-        parent_folder_id: Target folder ID in FangCloud
+        parent_folder_id: Target folder ID in FangCloud (value 0 represents the root directory ID of personal space)
         local_file_path: Local file path to upload
         
     Returns:
@@ -151,15 +151,15 @@ async def upload_file(parent_folder_id: str, local_file_path: str) -> Dict[str,
         return {"status": "error", "message": "local_file_path is required"}
     
     try:
-        # 获取文件名
+        # Get file name
         file_name = os.path.basename(local_file_path)
         
-        # 获取上传URL
+        # Get upload URL
         upload_url = await api.get_file_upload_url(parent_folder_id, file_name)
         if not upload_url:
             return {"status": "error", "message": f"Failed to get upload URL for {file_name}"}
         
-        # 上传文件
+        # Upload file
         result = await api.upload_file(upload_url, local_file_path)
         
         if result:
@@ -262,7 +262,7 @@ async def list_folder_contents(folder_id: str, page_id: Optional[int] = 0,
     List folder contents (files and subfolders)
     
     Args:
-        folder_id: Folder ID
+        folder_id: Folder ID (value 0 represents the root directory ID of personal space)
         page_id: Page number (optional, default 0)
         page_capacity: Page capacity (optional, default 20)
         type_filter: Filter by type - "file", "folder", or "all" (optional, default "all")

{fangcloud_mcp-0.1.5.dist-info → fangcloud_mcp-0.1.7.dist-info}/METADATA

@@ -1,176 +1,180 @@
-Metadata-Version: 2.4
-Name: fangcloud-mcp
-Version: 0.1.5
-Summary: FangCloud MCP 是一个 Model Context Protocol (MCP) 服务器实现，提供与 FangCloud 云存储服务的集成
-Home-page: https://github.com/example/fangcloud
-Author: FangCloud Developer
-Author-email: FangCloud Developer <dev@example.com>
-Keywords: fangcloud,mcp,cloud storage,api
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.12
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Topic :: Software Development :: Libraries
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: aiohttp>=3.8.6
-Requires-Dist: mcp[cli]>=1.7.1
-Dynamic: author
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: requires-python
-
-# FangCloud MCP
-
-FangCloud MCP 是一个 Model Context Protocol (MCP) 服务器实现，提供与 FangCloud 云存储服务的集成。通过该服务，AI 助手可以直接与 FangCloud 进行交互，实现文件和文件夹的管理操作。
-
-## 功能特点
-
-FangCloud MCP 提供以下功能：
-
-- 文件操作
-  - 获取文件信息
-  - 上传文件
-  - 下载文件
-  - 更新文件名称和描述
-- 文件夹操作
-  - 获取文件夹信息
-  - 创建文件夹
-  - 列出文件夹内容
-  - 列出个人空间项目
-- 搜索功能
-  - 按关键词搜索文件和文件夹
-  - 支持多种过滤和排序选项
-
-## 安装要求
-
-- Python 3.12 或更高版本
-- 依赖项:
-  - aiohttp >= 3.11.18
-  - mcp[cli] >= 1.7.1
-
-## 安装方法
-
-### 从 PyPI 安装（推荐）
-
-```bash
-pip install fangcloud
-```
-
-## 使用方法
-
-### 启动服务器
-
-服务器需要 FangCloud API 访问令牌才能运行：
-
-```bash
-python fangcloud.py --access_token <your-access-token>
-```
-
-或者使用简短参数形式：
-
-```bash
-python fangcloud.py -c <your-access-token>
-```
-
-### 日志
-
-服务器日志保存在`fangcloud-mcp.log`文件中，同时也会输出到控制台。
-
-## API 参考
-
-### 文件操作
-
-#### 获取文件信息
-
-```python
-get_file_info(file_id: str)
-```
-
-获取指定文件 ID 的详细信息。
-
-#### 上传文件
-
-```python
-upload_file(parent_folder_id: str, local_file_path: str)
-```
-
-将本地文件上传到指定的 FangCloud 文件夹。
-
-#### 下载文件
-
-```python
-download_file(file_id: str, local_path: str)
-```
-
-下载指定 ID 的文件到本地路径。
-
-#### 更新文件
-
-```python
-update_file(file_id: str, name: Optional[str] = None, description: Optional[str] = None)
-```
-
-更新文件的名称和/或描述。
-
-### 文件夹操作
-
-#### 获取文件夹信息
-
-```python
-get_folder_info(folder_id: str)
-```
-
-获取指定文件夹 ID 的详细信息。
-
-#### 创建文件夹
-
-```python
-create_folder(name: str, parent_id: str, target_space_type: Optional[str] = None, target_space_id: Optional[str] = None)
-```
-
-在指定的父文件夹中创建新文件夹。
-
-#### 列出文件夹内容
-
-```python
-list_folder_contents(folder_id: str, page_id: Optional[int] = 0, page_capacity: Optional[int] = 20, type_filter: Optional[str] = "all", sort_by: Optional[str] = "date", sort_direction: Optional[str] = "desc")
-```
-
-列出指定文件夹中的文件和子文件夹。
-
-#### 列出个人空间项目
-
-```python
-list_personal_items(page_id: Optional[int] = 0, page_capacity: Optional[int] = 20, type_filter: Optional[str] = "all", sort_by: Optional[str] = "date", sort_direction: Optional[str] = "desc")
-```
-
-列出个人空间中的文件和文件夹。
-
-### 搜索功能
-
-```python
-search_items(query_words: str, search_type: Optional[str] = "all", page_id: Optional[int] = 0, search_in_folder: Optional[str] = None, query_filter: Optional[str] = "all", updated_time_range: Optional[str] = None)
-```
-
-搜索文件和文件夹，支持多种过滤选项。
-
-## 开发
-
-### 项目结构
-
-- `fangcloud.py` - 主入口点，包含 MCP 服务器实现和工具函数
-- `fangcloud_api.py` - FangCloud API 客户端实现
-- `pyproject.toml` - 项目配置和依赖声明
-
-### 日志记录
-
-项目使用 Python 的标准 logging 模块记录日志，配置为同时输出到控制台和文件。
-
-## 许可证
-
-[添加许可证信息]
+Metadata-Version: 2.4
+Name: fangcloud-mcp
+Version: 0.1.7
+Summary: FangCloud MCP 是一个 Model Context Protocol (MCP) 服务器实现，提供与 FangCloud 云存储服务的集成
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: aiohttp>=3.8.6
+Requires-Dist: mcp[cli]>=1.7.1
+Description-Content-Type: text/markdown
+
+# FangCloud MCP
+
+FangCloud MCP 是一个 Model Context Protocol (MCP) 服务器实现，提供与 FangCloud 云存储服务的集成。通过该服务，AI 助手可以直接与 FangCloud 进行交互，实现文件和文件夹的管理操作。
+
+## 功能特点
+
+FangCloud MCP 提供以下功能：
+
+- 文件操作
+  - 获取文件信息
+  - 上传文件
+  - 下载文件
+  - 更新文件名称和描述
+- 文件夹操作
+  - 获取文件夹信息
+  - 创建文件夹
+  - 列出文件夹内容
+  - 列出个人空间项目
+- 搜索功能
+  - 按关键词搜索文件和文件夹
+  - 支持多种过滤和排序选项
+
+## 安装要求
+
+- Python 3.12 或更高版本
+- 依赖项:
+  - aiohttp >= 3.8.6
+  - mcp[cli] >= 1.7.1
+
+## 安装方法
+
+### 从 PyPI 安装（推荐）
+
+```bash
+pip install fangcloud-mcp
+```
+
+## 使用方法
+
+### 启动服务器
+
+服务器需要 FangCloud API 访问令牌才能运行：
+
+```bash
+fangcloud --access_token <your-access-token>
+```
+
+或者使用简短参数形式：
+
+```bash
+fangcloud -c <your-access-token>
+```
+
+### 日志
+
+服务器日志保存在`fangcloud-mcp.log`文件中，同时也会输出到控制台。
+
+## API 参考
+
+### 文件操作
+
+#### 获取文件信息
+
+```python
+get_file_info(file_id: str)
+```
+
+获取指定文件 ID 的详细信息。
+
+#### 上传文件
+
+```python
+upload_file(parent_folder_id: str, local_file_path: str)
+```
+
+将本地文件上传到指定的 FangCloud 文件夹。
+
+#### 下载文件
+
+```python
+download_file(file_id: str, local_path: str)
+```
+
+下载指定 ID 的文件到本地路径。
+
+#### 更新文件
+
+```python
+update_file(file_id: str, name: Optional[str] = None, description: Optional[str] = None)
+```
+
+更新文件的名称和/或描述。
+
+### 文件夹操作
+
+#### 获取文件夹信息
+
+```python
+get_folder_info(folder_id: str)
+```
+
+获取指定文件夹 ID 的详细信息。
+
+#### 创建文件夹
+
+```python
+create_folder(name: str, parent_id: str, target_space_type: Optional[str] = None, target_space_id: Optional[str] = None)
+```
+
+在指定的父文件夹中创建新文件夹。
+
+#### 列出文件夹内容
+
+```python
+list_folder_contents(folder_id: str, page_id: Optional[int] = 0, page_capacity: Optional[int] = 20, type_filter: Optional[str] = "all", sort_by: Optional[str] = "date", sort_direction: Optional[str] = "desc")
+```
+
+列出指定文件夹中的文件和子文件夹。
+
+#### 列出个人空间项目
+
+```python
+list_personal_items(page_id: Optional[int] = 0, page_capacity: Optional[int] = 20, type_filter: Optional[str] = "all", sort_by: Optional[str] = "date", sort_direction: Optional[str] = "desc")
+```
+
+列出个人空间中的文件和文件夹。
+
+### 搜索功能
+
+```python
+search_items(query_words: str, search_type: Optional[str] = "all", page_id: Optional[int] = 0, search_in_folder: Optional[str] = None, query_filter: Optional[str] = "all", updated_time_range: Optional[str] = None)
+```
+
+搜索文件和文件夹，支持多种过滤选项。
+
+## 开发
+
+### 项目结构
+
+- `fangcloud.py` - 主入口点，包含 MCP 服务器实现和工具函数
+- `fangcloud_api.py` - FangCloud API 客户端实现
+- `pyproject.toml` - 项目配置和依赖声明
+
+### 日志记录
+
+项目使用 Python 的标准 logging 模块记录日志，配置为同时输出到控制台和文件。
+
+## 许可证
+
+MIT License
+
+Copyright (c) 2025 FangCloud Developer
+
+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.

fangcloud_mcp-0.1.7.dist-info/RECORD

@@ -0,0 +1,8 @@
+fangcloud_mcp/__init__.py,sha256=sNSVoR1IBLBiMvnIY9KQZlURRfheArJL6U8YNJ51h0k,229
+fangcloud_mcp/fangcloud.py,sha256=M-xxEKuoM9agMLp81YG4q2nP0ZlYiSh4og7tIEJyTPU,14901
+fangcloud_mcp/fangcloud_api.py,sha256=QQWB8neT-XKfc854yhhZ9WihyN-aI5D_MbV_RRjf-VM,26579
+fangcloud_mcp-0.1.7.dist-info/METADATA,sha256=UugMfb3agFcOt29P5ACYC0sSEpiv1gT6FSCQY6db36g,4722
+fangcloud_mcp-0.1.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+fangcloud_mcp-0.1.7.dist-info/entry_points.txt,sha256=Rx2NYFMpIfV0Yc81Bpn_N-INU1LOxo59neT1Cicltwk,53
+fangcloud_mcp-0.1.7.dist-info/licenses/LICENSE,sha256=PLXgT5nqTcwqGoalBG1tGoXtGUHFunt4gK0M-GxPl6o,1097
+fangcloud_mcp-0.1.7.dist-info/RECORD,,

{fangcloud_mcp-0.1.5.dist-info → fangcloud_mcp-0.1.7.dist-info}/WHEEL

@@ -1,5 +1,4 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.3.1)
+Generator: hatchling 1.27.0
 Root-Is-Purelib: true
 Tag: py3-none-any
-

fangcloud_mcp-0.1.7.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+fangcloud-mcp = fangcloud_mcp:main

fangcloud_mcp-0.1.5.dist-info/RECORD

@@ -1,9 +0,0 @@
-fangcloud/__init__.py,sha256=xUeOczwkR-HFR0bI1EBHHuNCw_eQdZ7A35ob5swB4bM,254
-fangcloud/fangcloud.py,sha256=g5Q6por1kA5_KmYINmtusEEQhyWuGEBtHJRGpSD5Mb4,14661
-fangcloud/fangcloud_api.py,sha256=QQWB8neT-XKfc854yhhZ9WihyN-aI5D_MbV_RRjf-VM,26579
-fangcloud_mcp-0.1.5.dist-info/licenses/LICENSE,sha256=PLXgT5nqTcwqGoalBG1tGoXtGUHFunt4gK0M-GxPl6o,1097
-fangcloud_mcp-0.1.5.dist-info/METADATA,sha256=Di9bs7fLz6-nkUOOpHk9aiohNYhTRTf5nWpEpDk_A80,4528
-fangcloud_mcp-0.1.5.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
-fangcloud_mcp-0.1.5.dist-info/entry_points.txt,sha256=n3xxtybuLoNxx4J3OKlUOlaYrRbeTrnG6ANj5yhMRsc,55
-fangcloud_mcp-0.1.5.dist-info/top_level.txt,sha256=AugWwWUaSzLQQ1vZjMo8GoW-xHK7yyqLdyve4HuFfzg,10
-fangcloud_mcp-0.1.5.dist-info/RECORD,,

fangcloud_mcp-0.1.5.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-fangcloud = fangcloud.fangcloud:main

fangcloud_mcp-0.1.5.dist-info/top_level.txt

@@ -1 +0,0 @@
-fangcloud