iflow-mcp-xueqiu-mcp 0.1.0__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.
@@ -0,0 +1,96 @@
1
+ Metadata-Version: 2.4
2
+ Name: iflow-mcp-xueqiu-mcp
3
+ Version: 0.1.0
4
+ Summary: Add your description here
5
+ Requires-Python: >=3.11
6
+ Description-Content-Type: text/markdown
7
+ License-File: LICENSE
8
+ Requires-Dist: fastmcp>=2.1.2
9
+ Requires-Dist: pysnowball>=0.1.3
10
+ Requires-Dist: python-dotenv>=1.0.0
11
+ Dynamic: license-file
12
+
13
+ # Xueqiu MCP
14
+
15
+ 基于雪球API的MCP服务,让您通过Claude或其他AI助手轻松获取股票数据。
16
+
17
+ ## 项目简介
18
+
19
+ 本项目基于[pysnowball](https://github.com/uname-yang/pysnowball)封装了雪球API,并通过MCP协议提供服务,使您能够在Claude等AI助手中直接查询股票数据。
20
+
21
+ ## 安装方法
22
+
23
+ 本项目使用`uv`进行依赖管理。请按照以下步骤进行安装:
24
+
25
+ ```bash
26
+ # 克隆仓库
27
+ git clone https://github.com/liqiongyu/xueqiu_mcp.git
28
+ cd xueqiu_mcp
29
+
30
+ # 使用uv安装依赖
31
+ uv venv && uv pip install -e .
32
+ ```
33
+
34
+ ## 配置
35
+
36
+ ### 配置雪球Token
37
+
38
+ 1. 在项目根目录创建`.env`文件
39
+ 2. 添加以下内容:
40
+
41
+ ```
42
+ XUEQIU_TOKEN=您的雪球token
43
+ ```
44
+
45
+ * 快捷方式:
46
+
47
+ ```bash
48
+ echo 'XUEQIU_TOKEN="xq_a_token=xxxxx;u=xxxx"' > .env
49
+ ```
50
+
51
+ 关于如何获取雪球token,请参考[pysnowball文档](https://github.com/uname-yang/pysnowball/blob/master/how_to_get_token.md)。
52
+
53
+ ## 运行服务
54
+
55
+ 使用以下命令启动MCP服务:
56
+
57
+ ```bash
58
+ uv --directory /path/to/xueqiu_mcp run main.py
59
+ ```
60
+
61
+ 或者,如果您已经配置了Claude Desktop:
62
+
63
+ ```json
64
+ "xueqiu-mcp": {
65
+ "args": [
66
+ "--directory",
67
+ "/path/to/xueqiu_mcp",
68
+ "run",
69
+ "main.py"
70
+ ],
71
+ "command": "uv"
72
+ }
73
+ ```
74
+
75
+ ## 功能特性
76
+
77
+ - 获取股票实时行情
78
+ - 查询指数收益
79
+ - 获取深港通/沪港通北向数据
80
+ - 基金相关数据查询
81
+ - 关键词搜索股票代码
82
+
83
+ ## 展示图
84
+
85
+ ![image](./images/cursor_mcp.png)
86
+
87
+ ![image](./images/claude_mcp.png)
88
+
89
+ ## 致谢
90
+
91
+ - [pysnowball](https://github.com/uname-yang/pysnowball) - 雪球股票数据接口的Python版本
92
+ - [fastmcp](https://github.com/fastmcp) - MCP服务框架
93
+
94
+ ## 许可证
95
+
96
+ [MIT License](./LICENSE)
@@ -0,0 +1,5 @@
1
+ iflow_mcp_xueqiu_mcp-0.1.0.dist-info/licenses/LICENSE,sha256=dTK_2cGN2LGrnEbNEnvcYGG-Qadqw-Pj6dMnRoFwZTM,1065
2
+ iflow_mcp_xueqiu_mcp-0.1.0.dist-info/METADATA,sha256=BAHz-S9FuNYSHjiq204EezYZ2SF0gVWKwQkgC-CN_R4,1987
3
+ iflow_mcp_xueqiu_mcp-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
4
+ iflow_mcp_xueqiu_mcp-0.1.0.dist-info/top_level.txt,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
5
+ iflow_mcp_xueqiu_mcp-0.1.0.dist-info/RECORD,,
@@ -0,0 +1,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: setuptools (80.9.0)
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
5
+
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 李琼羽
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.