fangcloud-mcp 0.1.2__py3-none-any.whl → 0.1.4__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,7 +2,7 @@
2
2
  FangCloud MCP - Model Context Protocol (MCP) 服务器实现,提供与 FangCloud 云存储服务的集成
3
3
  """
4
4
 
5
- __version__ = "0.1.1"
5
+ __version__ = "0.1.4"
6
6
 
7
7
  from .fangcloud import main
8
8
  from .fangcloud_api import FangcloudAPI
@@ -16,7 +16,7 @@ from .fangcloud_api import FangcloudAPI
16
16
 
17
17
 
18
18
  # Configure logging
19
- DEFAULT_LOG_FILE = "fangcloud_mcp.log"
19
+ DEFAULT_LOG_FILE = "fangcloud-mcp.log"
20
20
  logging.basicConfig(
21
21
  level=logging.INFO,
22
22
  format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
@@ -1,198 +1,176 @@
1
- Metadata-Version: 2.1
2
- Name: fangcloud-mcp
3
- Version: 0.1.2
4
- Summary: FangCloud MCP 是一个 Model Context Protocol (MCP) 服务器实现,提供与 FangCloud 云存储服务的集成
5
- Home-page: https://github.com/example/fangcloud-mcp
6
- Author: FangCloud Developer
7
- Author-email: dev@example.com
8
- License: UNKNOWN
9
- Project-URL: Bug Reports, https://github.com/example/fangcloud-mcp/issues
10
- Project-URL: Source, https://github.com/example/fangcloud-mcp
11
- Project-URL: Documentation, https://github.com/example/fangcloud-mcp#readme
12
- Keywords: fangcloud,mcp,cloud storage,api
13
- Platform: UNKNOWN
14
- Classifier: Development Status :: 4 - Beta
15
- Classifier: Intended Audience :: Developers
16
- Classifier: Programming Language :: Python :: 3
17
- Classifier: Programming Language :: Python :: 3.12
18
- Classifier: License :: OSI Approved :: MIT License
19
- Classifier: Operating System :: OS Independent
20
- Classifier: Topic :: Software Development :: Libraries
21
- Classifier: Topic :: Software Development :: Libraries :: Python Modules
22
- Requires-Python: >=3.12
23
- Description-Content-Type: text/markdown
24
- License-File: LICENSE
25
- Requires-Dist: aiohttp (>=3.11.18)
26
- Requires-Dist: mcp[cli] (>=1.7.1)
27
-
28
- # FangCloud MCP
29
-
30
- FangCloud MCP 是一个 Model Context Protocol (MCP) 服务器实现,提供与 FangCloud 云存储服务的集成。通过该服务,AI 助手可以直接与 FangCloud 进行交互,实现文件和文件夹的管理操作。
31
-
32
- ## 功能特点
33
-
34
- FangCloud MCP 提供以下功能:
35
-
36
- - 文件操作
37
- - 获取文件信息
38
- - 上传文件
39
- - 下载文件
40
- - 更新文件名称和描述
41
- - 文件夹操作
42
- - 获取文件夹信息
43
- - 创建文件夹
44
- - 列出文件夹内容
45
- - 列出个人空间项目
46
- - 搜索功能
47
- - 按关键词搜索文件和文件夹
48
- - 支持多种过滤和排序选项
49
-
50
- ## 安装要求
51
-
52
- - Python 3.12 或更高版本
53
- - 依赖项:
54
- - aiohttp >= 3.11.18
55
- - mcp[cli] >= 1.7.1
56
-
57
- ## 安装方法
58
-
59
- ### 从 PyPI 安装(推荐)
60
-
61
- ```bash
62
- pip install fangcloud-mcp
63
- ```
64
-
65
- ### 从源码安装
66
-
67
- ```bash
68
- # 克隆仓库
69
- git clone https://github.com/example/fangcloud-mcp.git
70
- cd fangcloud-mcp
71
-
72
- # 使用pip安装
73
- pip install .
74
- ```
75
-
76
- ### 开发模式安装
77
-
78
- ```bash
79
- git clone https://github.com/example/fangcloud-mcp.git
80
- cd fangcloud-mcp
81
- pip install -e .
82
- ```
83
-
84
- ## 使用方法
85
-
86
- ### 启动服务器
87
-
88
- 服务器需要 FangCloud API 访问令牌才能运行:
89
-
90
- ```bash
91
- python fangcloud.py --access_token <your-access-token>
92
- ```
93
-
94
- 或者使用简短参数形式:
95
-
96
- ```bash
97
- python fangcloud.py -c <your-access-token>
98
- ```
99
-
100
- ### 日志
101
-
102
- 服务器日志保存在`fangcloud_mcp.log`文件中,同时也会输出到控制台。
103
-
104
- ## API 参考
105
-
106
- ### 文件操作
107
-
108
- #### 获取文件信息
109
-
110
- ```python
111
- get_file_info(file_id: str)
112
- ```
113
-
114
- 获取指定文件 ID 的详细信息。
115
-
116
- #### 上传文件
117
-
118
- ```python
119
- upload_file(parent_folder_id: str, local_file_path: str)
120
- ```
121
-
122
- 将本地文件上传到指定的 FangCloud 文件夹。
123
-
124
- #### 下载文件
125
-
126
- ```python
127
- download_file(file_id: str, local_path: str)
128
- ```
129
-
130
- 下载指定 ID 的文件到本地路径。
131
-
132
- #### 更新文件
133
-
134
- ```python
135
- update_file(file_id: str, name: Optional[str] = None, description: Optional[str] = None)
136
- ```
137
-
138
- 更新文件的名称和/或描述。
139
-
140
- ### 文件夹操作
141
-
142
- #### 获取文件夹信息
143
-
144
- ```python
145
- get_folder_info(folder_id: str)
146
- ```
147
-
148
- 获取指定文件夹 ID 的详细信息。
149
-
150
- #### 创建文件夹
151
-
152
- ```python
153
- create_folder(name: str, parent_id: str, target_space_type: Optional[str] = None, target_space_id: Optional[str] = None)
154
- ```
155
-
156
- 在指定的父文件夹中创建新文件夹。
157
-
158
- #### 列出文件夹内容
159
-
160
- ```python
161
- 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")
162
- ```
163
-
164
- 列出指定文件夹中的文件和子文件夹。
165
-
166
- #### 列出个人空间项目
167
-
168
- ```python
169
- 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")
170
- ```
171
-
172
- 列出个人空间中的文件和文件夹。
173
-
174
- ### 搜索功能
175
-
176
- ```python
177
- 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)
178
- ```
179
-
180
- 搜索文件和文件夹,支持多种过滤选项。
181
-
182
- ## 开发
183
-
184
- ### 项目结构
185
-
186
- - `fangcloud.py` - 主入口点,包含 MCP 服务器实现和工具函数
187
- - `fangcloud_api.py` - FangCloud API 客户端实现
188
- - `pyproject.toml` - 项目配置和依赖声明
189
-
190
- ### 日志记录
191
-
192
- 项目使用 Python 的标准 logging 模块记录日志,配置为同时输出到控制台和文件。
193
-
194
- ## 许可证
195
-
196
- [添加许可证信息]
197
-
198
-
1
+ Metadata-Version: 2.4
2
+ Name: fangcloud-mcp
3
+ Version: 0.1.4
4
+ Summary: FangCloud MCP 是一个 Model Context Protocol (MCP) 服务器实现,提供与 FangCloud 云存储服务的集成
5
+ Home-page: https://github.com/example/fangcloud
6
+ Author: FangCloud Developer
7
+ Author-email: FangCloud Developer <dev@example.com>
8
+ Keywords: fangcloud,mcp,cloud storage,api
9
+ Classifier: Development Status :: 4 - Beta
10
+ Classifier: Intended Audience :: Developers
11
+ Classifier: Programming Language :: Python :: 3
12
+ Classifier: Programming Language :: Python :: 3.12
13
+ Classifier: License :: OSI Approved :: MIT License
14
+ Classifier: Operating System :: OS Independent
15
+ Classifier: Topic :: Software Development :: Libraries
16
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
17
+ Requires-Python: >=3.12
18
+ Description-Content-Type: text/markdown
19
+ License-File: LICENSE
20
+ Requires-Dist: aiohttp>=3.11.18
21
+ Requires-Dist: mcp[cli]>=1.7.1
22
+ Dynamic: author
23
+ Dynamic: home-page
24
+ Dynamic: license-file
25
+ Dynamic: requires-python
26
+
27
+ # FangCloud MCP
28
+
29
+ FangCloud MCP 是一个 Model Context Protocol (MCP) 服务器实现,提供与 FangCloud 云存储服务的集成。通过该服务,AI 助手可以直接与 FangCloud 进行交互,实现文件和文件夹的管理操作。
30
+
31
+ ## 功能特点
32
+
33
+ FangCloud MCP 提供以下功能:
34
+
35
+ - 文件操作
36
+ - 获取文件信息
37
+ - 上传文件
38
+ - 下载文件
39
+ - 更新文件名称和描述
40
+ - 文件夹操作
41
+ - 获取文件夹信息
42
+ - 创建文件夹
43
+ - 列出文件夹内容
44
+ - 列出个人空间项目
45
+ - 搜索功能
46
+ - 按关键词搜索文件和文件夹
47
+ - 支持多种过滤和排序选项
48
+
49
+ ## 安装要求
50
+
51
+ - Python 3.12 或更高版本
52
+ - 依赖项:
53
+ - aiohttp >= 3.11.18
54
+ - mcp[cli] >= 1.7.1
55
+
56
+ ## 安装方法
57
+
58
+ ### 从 PyPI 安装(推荐)
59
+
60
+ ```bash
61
+ pip install fangcloud
62
+ ```
63
+
64
+ ## 使用方法
65
+
66
+ ### 启动服务器
67
+
68
+ 服务器需要 FangCloud API 访问令牌才能运行:
69
+
70
+ ```bash
71
+ python fangcloud.py --access_token <your-access-token>
72
+ ```
73
+
74
+ 或者使用简短参数形式:
75
+
76
+ ```bash
77
+ python fangcloud.py -c <your-access-token>
78
+ ```
79
+
80
+ ### 日志
81
+
82
+ 服务器日志保存在`fangcloud-mcp.log`文件中,同时也会输出到控制台。
83
+
84
+ ## API 参考
85
+
86
+ ### 文件操作
87
+
88
+ #### 获取文件信息
89
+
90
+ ```python
91
+ get_file_info(file_id: str)
92
+ ```
93
+
94
+ 获取指定文件 ID 的详细信息。
95
+
96
+ #### 上传文件
97
+
98
+ ```python
99
+ upload_file(parent_folder_id: str, local_file_path: str)
100
+ ```
101
+
102
+ 将本地文件上传到指定的 FangCloud 文件夹。
103
+
104
+ #### 下载文件
105
+
106
+ ```python
107
+ download_file(file_id: str, local_path: str)
108
+ ```
109
+
110
+ 下载指定 ID 的文件到本地路径。
111
+
112
+ #### 更新文件
113
+
114
+ ```python
115
+ update_file(file_id: str, name: Optional[str] = None, description: Optional[str] = None)
116
+ ```
117
+
118
+ 更新文件的名称和/或描述。
119
+
120
+ ### 文件夹操作
121
+
122
+ #### 获取文件夹信息
123
+
124
+ ```python
125
+ get_folder_info(folder_id: str)
126
+ ```
127
+
128
+ 获取指定文件夹 ID 的详细信息。
129
+
130
+ #### 创建文件夹
131
+
132
+ ```python
133
+ create_folder(name: str, parent_id: str, target_space_type: Optional[str] = None, target_space_id: Optional[str] = None)
134
+ ```
135
+
136
+ 在指定的父文件夹中创建新文件夹。
137
+
138
+ #### 列出文件夹内容
139
+
140
+ ```python
141
+ 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")
142
+ ```
143
+
144
+ 列出指定文件夹中的文件和子文件夹。
145
+
146
+ #### 列出个人空间项目
147
+
148
+ ```python
149
+ 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")
150
+ ```
151
+
152
+ 列出个人空间中的文件和文件夹。
153
+
154
+ ### 搜索功能
155
+
156
+ ```python
157
+ 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)
158
+ ```
159
+
160
+ 搜索文件和文件夹,支持多种过滤选项。
161
+
162
+ ## 开发
163
+
164
+ ### 项目结构
165
+
166
+ - `fangcloud.py` - 主入口点,包含 MCP 服务器实现和工具函数
167
+ - `fangcloud_api.py` - FangCloud API 客户端实现
168
+ - `pyproject.toml` - 项目配置和依赖声明
169
+
170
+ ### 日志记录
171
+
172
+ 项目使用 Python 的标准 logging 模块记录日志,配置为同时输出到控制台和文件。
173
+
174
+ ## 许可证
175
+
176
+ [添加许可证信息]
@@ -0,0 +1,9 @@
1
+ fangcloud/__init__.py,sha256=xUeOczwkR-HFR0bI1EBHHuNCw_eQdZ7A35ob5swB4bM,254
2
+ fangcloud/fangcloud.py,sha256=g5Q6por1kA5_KmYINmtusEEQhyWuGEBtHJRGpSD5Mb4,14661
3
+ fangcloud/fangcloud_api.py,sha256=QQWB8neT-XKfc854yhhZ9WihyN-aI5D_MbV_RRjf-VM,26579
4
+ fangcloud_mcp-0.1.4.dist-info/licenses/LICENSE,sha256=PLXgT5nqTcwqGoalBG1tGoXtGUHFunt4gK0M-GxPl6o,1097
5
+ fangcloud_mcp-0.1.4.dist-info/METADATA,sha256=PvzrzNkUN_4lugUkPJ6OMVKpvB7qMm8bIZscre2C-8c,4530
6
+ fangcloud_mcp-0.1.4.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
7
+ fangcloud_mcp-0.1.4.dist-info/entry_points.txt,sha256=n3xxtybuLoNxx4J3OKlUOlaYrRbeTrnG6ANj5yhMRsc,55
8
+ fangcloud_mcp-0.1.4.dist-info/top_level.txt,sha256=AugWwWUaSzLQQ1vZjMo8GoW-xHK7yyqLdyve4HuFfzg,10
9
+ fangcloud_mcp-0.1.4.dist-info/RECORD,,
@@ -1,5 +1,5 @@
1
1
  Wheel-Version: 1.0
2
- Generator: bdist_wheel (0.37.1)
2
+ Generator: setuptools (80.3.1)
3
3
  Root-Is-Purelib: true
4
4
  Tag: py3-none-any
5
5
 
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ fangcloud = fangcloud.fangcloud:main
@@ -0,0 +1 @@
1
+ fangcloud
@@ -1,9 +0,0 @@
1
- fangcloud-mcp/__init__.py,sha256=fVFqgXkWSUiK1z-GKbZdCUY0b8zlv-jeQeOYHO5-R80,254
2
- fangcloud-mcp/fangcloud.py,sha256=L5QPVBmY95QbVD68t_xCSHSkXw7B_5OHi_20jAx5qz0,14661
3
- fangcloud-mcp/fangcloud_api.py,sha256=QQWB8neT-XKfc854yhhZ9WihyN-aI5D_MbV_RRjf-VM,26579
4
- fangcloud_mcp-0.1.2.dist-info/LICENSE,sha256=PLXgT5nqTcwqGoalBG1tGoXtGUHFunt4gK0M-GxPl6o,1097
5
- fangcloud_mcp-0.1.2.dist-info/METADATA,sha256=Op8laGdcgYEFCYv8esvQFta9D0089BGoI7wdzgWHK9w,4793
6
- fangcloud_mcp-0.1.2.dist-info/WHEEL,sha256=G16H4A3IeoQmnOrYV4ueZGKSjhipXx8zc8nu9FGlvMA,92
7
- fangcloud_mcp-0.1.2.dist-info/entry_points.txt,sha256=cLC2ygrgh8n0kfch8zaPrk5xvyOOVmOW0CRmnkD7KXw,64
8
- fangcloud_mcp-0.1.2.dist-info/top_level.txt,sha256=7whH_Yk8uCosRXkTZto2fjFqIqLAoEWwVcfPXaMgAz4,14
9
- fangcloud_mcp-0.1.2.dist-info/RECORD,,
@@ -1,3 +0,0 @@
1
- [console_scripts]
2
- fangcloud-mcp = fangcloud_mcp.fangcloud:main
3
-
@@ -1 +0,0 @@
1
- fangcloud-mcp
File without changes