yfin-mcp 0.1.0__tar.gz → 0.2.4__tar.gz

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.
@@ -1,10 +1,10 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: yfin-mcp
3
- Version: 0.1.0
3
+ Version: 0.2.4
4
4
  Summary: Enhanced Yahoo Finance MCP Server with intelligent pagination, caching, and LLM-optimized responses
5
5
  Author: AlexYoung (Original Author)
6
6
  Author-email: fritzprix <innocentevil0914@gmail.com>
7
- License: MIT
7
+ License-Expression: MIT
8
8
  Project-URL: Homepage, https://github.com/fritzprix/yahoo-finance-mcp
9
9
  Project-URL: Repository, https://github.com/fritzprix/yahoo-finance-mcp
10
10
  Project-URL: Issues, https://github.com/fritzprix/yahoo-finance-mcp/issues
@@ -13,7 +13,6 @@ Keywords: mcp,model-context-protocol,yahoo-finance,yfinance,financial-data,stock
13
13
  Classifier: Development Status :: 4 - Beta
14
14
  Classifier: Intended Audience :: Developers
15
15
  Classifier: Intended Audience :: Financial and Insurance Industry
16
- Classifier: License :: OSI Approved :: MIT License
17
16
  Classifier: Programming Language :: Python :: 3
18
17
  Classifier: Programming Language :: Python :: 3.11
19
18
  Classifier: Programming Language :: Python :: 3.12
@@ -173,11 +172,21 @@ With this MCP server, you can use Claude to:
173
172
  - pydantic
174
173
  - and other packages for data processing
175
174
 
176
- ## Setup
175
+ ## Installation
176
+
177
+ ### From PyPI (Recommended)
178
+
179
+ Install the package directly from PyPI:
180
+
181
+ ```bash
182
+ pip install yfin-mcp
183
+ ```
184
+
185
+ ### From Source
177
186
 
178
187
  1. Clone this repository:
179
188
  ```bash
180
- git clone https://github.com/Alex2Yang97/yahoo-finance-mcp.git
189
+ git clone https://github.com/fritzprix/yahoo-finance-mcp.git
181
190
  cd yahoo-finance-mcp
182
191
  ```
183
192
 
@@ -190,27 +199,47 @@ With this MCP server, you can use Claude to:
190
199
 
191
200
  ## Usage
192
201
 
193
- ### Development Mode
202
+ ### Integration with Claude for Desktop
194
203
 
195
- You can test the server with MCP Inspector by running:
204
+ After installing the package, you can integrate it with Claude for Desktop:
196
205
 
197
- ```bash
198
- uv run server.py
199
- ```
206
+ 1. **Install the package** (if not already installed):
207
+ ```bash
208
+ pip install yfin-mcp
209
+ ```
200
210
 
201
- This will start the server and allow you to test the available tools.
211
+ 2. **Configure Claude Desktop**:
212
+ - MacOS: Edit `~/Library/Application Support/Claude/claude_desktop_config.json`
213
+ - Windows: Edit `%APPDATA%\Claude\claude_desktop_config.json`
202
214
 
203
- ### Integration with Claude for Desktop
215
+ 3. **Add the server configuration**:
204
216
 
205
- To integrate this server with Claude for Desktop:
217
+ **Using uvx (Recommended - No installation needed)**:
218
+ ```json
219
+ {
220
+ "mcpServers": {
221
+ "yfinance": {
222
+ "command": "uvx",
223
+ "args": ["yfin-mcp"]
224
+ }
225
+ }
226
+ }
227
+ ```
206
228
 
207
- 1. Install Claude for Desktop to your local machine.
208
- 2. Install VS Code to your local machine. Then run the following command to open the `claude_desktop_config.json` file:
209
- - MacOS: `code ~/Library/Application\ Support/Claude/claude_desktop_config.json`
210
- - Windows: `code $env:AppData\Claude\claude_desktop_config.json`
229
+ **Using Python directly (if installed via pip)**:
230
+ ```json
231
+ {
232
+ "mcpServers": {
233
+ "yfinance": {
234
+ "command": "python",
235
+ "args": ["-m", "yfin_mcp"]
236
+ }
237
+ }
238
+ }
239
+ ```
211
240
 
212
- 3. Edit the Claude for Desktop config file, located at:
213
- - macOS:
241
+ **For development/source installation**:
242
+ - macOS:
214
243
  ```json
215
244
  {
216
245
  "mcpServers": {
@@ -218,7 +247,7 @@ To integrate this server with Claude for Desktop:
218
247
  "command": "uv",
219
248
  "args": [
220
249
  "--directory",
221
- "/ABSOLUTE/PATH/TO/PARENT/FOLDER/yahoo-finance-mcp",
250
+ "/ABSOLUTE/PATH/TO/yahoo-finance-mcp",
222
251
  "run",
223
252
  "server.py"
224
253
  ]
@@ -234,7 +263,7 @@ To integrate this server with Claude for Desktop:
234
263
  "command": "uv",
235
264
  "args": [
236
265
  "--directory",
237
- "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\yahoo-finance-mcp",
266
+ "C:\\ABSOLUTE\\PATH\\TO\\yahoo-finance-mcp",
238
267
  "run",
239
268
  "server.py"
240
269
  ]
@@ -243,9 +272,50 @@ To integrate this server with Claude for Desktop:
243
272
  }
244
273
  ```
245
274
 
246
- - **Note**: You may need to put the full path to the uv executable in the command field. You can get this by running `which uv` on MacOS/Linux or `where uv` on Windows.
275
+ 4. **Restart Claude for Desktop**
276
+
277
+ ### Development Mode
278
+
279
+ For testing with MCP Inspector:
280
+
281
+ ```bash
282
+ # From source
283
+ uv run server.py
284
+
285
+ # Or if installed via pip
286
+ python -m yfin_mcp
287
+ ```
288
+
289
+ ## Publishing to PyPI
290
+
291
+ To build and publish the package, use the provided scripts. You can optionally provide an argument to bump the version:
292
+
293
+ ### Windows
294
+ ```bash
295
+ # Just build and publish current version
296
+ publish_package.bat
297
+
298
+ # Bump version and then publish
299
+ publish_package.bat patch
300
+ publish_package.bat minor
301
+ publish_package.bat major
302
+ ```
303
+
304
+ ### macOS/Linux
305
+ ```bash
306
+ chmod +x publish_package.sh
307
+
308
+ # Just build and publish current version
309
+ ./publish_package.sh
310
+
311
+ # Bump version and then publish
312
+ ./publish_package.sh patch
313
+ ./publish_package.sh minor
314
+ ./publish_package.sh major
315
+ ```
247
316
 
248
- 4. Restart Claude for Desktop
317
+ > [!NOTE]
318
+ > The scripts will build the package into the `dist/` directory and then use `uv publish` to upload it. Ensure you have your PyPI credentials configured in `~/.pypirc` (or `%HOME%\.pypirc` on Windows) or set the `UV_PUBLISH_TOKEN` environment variable.
249
319
 
250
320
  ## License
251
321
 
@@ -140,11 +140,21 @@ With this MCP server, you can use Claude to:
140
140
  - pydantic
141
141
  - and other packages for data processing
142
142
 
143
- ## Setup
143
+ ## Installation
144
+
145
+ ### From PyPI (Recommended)
146
+
147
+ Install the package directly from PyPI:
148
+
149
+ ```bash
150
+ pip install yfin-mcp
151
+ ```
152
+
153
+ ### From Source
144
154
 
145
155
  1. Clone this repository:
146
156
  ```bash
147
- git clone https://github.com/Alex2Yang97/yahoo-finance-mcp.git
157
+ git clone https://github.com/fritzprix/yahoo-finance-mcp.git
148
158
  cd yahoo-finance-mcp
149
159
  ```
150
160
 
@@ -157,27 +167,47 @@ With this MCP server, you can use Claude to:
157
167
 
158
168
  ## Usage
159
169
 
160
- ### Development Mode
170
+ ### Integration with Claude for Desktop
161
171
 
162
- You can test the server with MCP Inspector by running:
172
+ After installing the package, you can integrate it with Claude for Desktop:
163
173
 
164
- ```bash
165
- uv run server.py
166
- ```
174
+ 1. **Install the package** (if not already installed):
175
+ ```bash
176
+ pip install yfin-mcp
177
+ ```
167
178
 
168
- This will start the server and allow you to test the available tools.
179
+ 2. **Configure Claude Desktop**:
180
+ - MacOS: Edit `~/Library/Application Support/Claude/claude_desktop_config.json`
181
+ - Windows: Edit `%APPDATA%\Claude\claude_desktop_config.json`
169
182
 
170
- ### Integration with Claude for Desktop
183
+ 3. **Add the server configuration**:
171
184
 
172
- To integrate this server with Claude for Desktop:
185
+ **Using uvx (Recommended - No installation needed)**:
186
+ ```json
187
+ {
188
+ "mcpServers": {
189
+ "yfinance": {
190
+ "command": "uvx",
191
+ "args": ["yfin-mcp"]
192
+ }
193
+ }
194
+ }
195
+ ```
173
196
 
174
- 1. Install Claude for Desktop to your local machine.
175
- 2. Install VS Code to your local machine. Then run the following command to open the `claude_desktop_config.json` file:
176
- - MacOS: `code ~/Library/Application\ Support/Claude/claude_desktop_config.json`
177
- - Windows: `code $env:AppData\Claude\claude_desktop_config.json`
197
+ **Using Python directly (if installed via pip)**:
198
+ ```json
199
+ {
200
+ "mcpServers": {
201
+ "yfinance": {
202
+ "command": "python",
203
+ "args": ["-m", "yfin_mcp"]
204
+ }
205
+ }
206
+ }
207
+ ```
178
208
 
179
- 3. Edit the Claude for Desktop config file, located at:
180
- - macOS:
209
+ **For development/source installation**:
210
+ - macOS:
181
211
  ```json
182
212
  {
183
213
  "mcpServers": {
@@ -185,7 +215,7 @@ To integrate this server with Claude for Desktop:
185
215
  "command": "uv",
186
216
  "args": [
187
217
  "--directory",
188
- "/ABSOLUTE/PATH/TO/PARENT/FOLDER/yahoo-finance-mcp",
218
+ "/ABSOLUTE/PATH/TO/yahoo-finance-mcp",
189
219
  "run",
190
220
  "server.py"
191
221
  ]
@@ -201,7 +231,7 @@ To integrate this server with Claude for Desktop:
201
231
  "command": "uv",
202
232
  "args": [
203
233
  "--directory",
204
- "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\yahoo-finance-mcp",
234
+ "C:\\ABSOLUTE\\PATH\\TO\\yahoo-finance-mcp",
205
235
  "run",
206
236
  "server.py"
207
237
  ]
@@ -210,9 +240,50 @@ To integrate this server with Claude for Desktop:
210
240
  }
211
241
  ```
212
242
 
213
- - **Note**: You may need to put the full path to the uv executable in the command field. You can get this by running `which uv` on MacOS/Linux or `where uv` on Windows.
243
+ 4. **Restart Claude for Desktop**
244
+
245
+ ### Development Mode
246
+
247
+ For testing with MCP Inspector:
248
+
249
+ ```bash
250
+ # From source
251
+ uv run server.py
252
+
253
+ # Or if installed via pip
254
+ python -m yfin_mcp
255
+ ```
256
+
257
+ ## Publishing to PyPI
258
+
259
+ To build and publish the package, use the provided scripts. You can optionally provide an argument to bump the version:
260
+
261
+ ### Windows
262
+ ```bash
263
+ # Just build and publish current version
264
+ publish_package.bat
265
+
266
+ # Bump version and then publish
267
+ publish_package.bat patch
268
+ publish_package.bat minor
269
+ publish_package.bat major
270
+ ```
271
+
272
+ ### macOS/Linux
273
+ ```bash
274
+ chmod +x publish_package.sh
275
+
276
+ # Just build and publish current version
277
+ ./publish_package.sh
278
+
279
+ # Bump version and then publish
280
+ ./publish_package.sh patch
281
+ ./publish_package.sh minor
282
+ ./publish_package.sh major
283
+ ```
214
284
 
215
- 4. Restart Claude for Desktop
285
+ > [!NOTE]
286
+ > The scripts will build the package into the `dist/` directory and then use `uv publish` to upload it. Ensure you have your PyPI credentials configured in `~/.pypirc` (or `%HOME%\.pypirc` on Windows) or set the `UV_PUBLISH_TOKEN` environment variable.
216
287
 
217
288
  ## License
218
289
 
@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "yfin-mcp"
7
- version = "0.1.0"
7
+ version = "0.2.4"
8
8
  description = "Enhanced Yahoo Finance MCP Server with intelligent pagination, caching, and LLM-optimized responses"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.11"
11
- license = {text = "MIT"}
11
+ license = "MIT"
12
12
  authors = [
13
13
  {name = "fritzprix", email = "innocentevil0914@gmail.com"},
14
14
  {name = "AlexYoung (Original Author)"}
@@ -27,7 +27,6 @@ classifiers = [
27
27
  "Development Status :: 4 - Beta",
28
28
  "Intended Audience :: Developers",
29
29
  "Intended Audience :: Financial and Insurance Industry",
30
- "License :: OSI Approved :: MIT License",
31
30
  "Programming Language :: Python :: 3",
32
31
  "Programming Language :: Python :: 3.11",
33
32
  "Programming Language :: Python :: 3.12",
@@ -40,6 +39,9 @@ dependencies = [
40
39
  "pandas>=2.0.0",
41
40
  ]
42
41
 
42
+ [project.scripts]
43
+ yfin-mcp = "server:main"
44
+
43
45
  [project.urls]
44
46
  Homepage = "https://github.com/fritzprix/yahoo-finance-mcp"
45
47
  Repository = "https://github.com/fritzprix/yahoo-finance-mcp"
@@ -72,7 +74,7 @@ extend-ignore = ["E203"]
72
74
  exclude = [".git", "__pycache__", "build", "dist", ".venv"]
73
75
 
74
76
  [tool.mypy]
75
- python_version = "3.11"
77
+ python_version = "0.2.4"
76
78
  warn_return_any = true
77
79
  warn_unused_configs = true
78
80
  disallow_untyped_defs = true
@@ -1,10 +1,10 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: yfin-mcp
3
- Version: 0.1.0
3
+ Version: 0.2.4
4
4
  Summary: Enhanced Yahoo Finance MCP Server with intelligent pagination, caching, and LLM-optimized responses
5
5
  Author: AlexYoung (Original Author)
6
6
  Author-email: fritzprix <innocentevil0914@gmail.com>
7
- License: MIT
7
+ License-Expression: MIT
8
8
  Project-URL: Homepage, https://github.com/fritzprix/yahoo-finance-mcp
9
9
  Project-URL: Repository, https://github.com/fritzprix/yahoo-finance-mcp
10
10
  Project-URL: Issues, https://github.com/fritzprix/yahoo-finance-mcp/issues
@@ -13,7 +13,6 @@ Keywords: mcp,model-context-protocol,yahoo-finance,yfinance,financial-data,stock
13
13
  Classifier: Development Status :: 4 - Beta
14
14
  Classifier: Intended Audience :: Developers
15
15
  Classifier: Intended Audience :: Financial and Insurance Industry
16
- Classifier: License :: OSI Approved :: MIT License
17
16
  Classifier: Programming Language :: Python :: 3
18
17
  Classifier: Programming Language :: Python :: 3.11
19
18
  Classifier: Programming Language :: Python :: 3.12
@@ -173,11 +172,21 @@ With this MCP server, you can use Claude to:
173
172
  - pydantic
174
173
  - and other packages for data processing
175
174
 
176
- ## Setup
175
+ ## Installation
176
+
177
+ ### From PyPI (Recommended)
178
+
179
+ Install the package directly from PyPI:
180
+
181
+ ```bash
182
+ pip install yfin-mcp
183
+ ```
184
+
185
+ ### From Source
177
186
 
178
187
  1. Clone this repository:
179
188
  ```bash
180
- git clone https://github.com/Alex2Yang97/yahoo-finance-mcp.git
189
+ git clone https://github.com/fritzprix/yahoo-finance-mcp.git
181
190
  cd yahoo-finance-mcp
182
191
  ```
183
192
 
@@ -190,27 +199,47 @@ With this MCP server, you can use Claude to:
190
199
 
191
200
  ## Usage
192
201
 
193
- ### Development Mode
202
+ ### Integration with Claude for Desktop
194
203
 
195
- You can test the server with MCP Inspector by running:
204
+ After installing the package, you can integrate it with Claude for Desktop:
196
205
 
197
- ```bash
198
- uv run server.py
199
- ```
206
+ 1. **Install the package** (if not already installed):
207
+ ```bash
208
+ pip install yfin-mcp
209
+ ```
200
210
 
201
- This will start the server and allow you to test the available tools.
211
+ 2. **Configure Claude Desktop**:
212
+ - MacOS: Edit `~/Library/Application Support/Claude/claude_desktop_config.json`
213
+ - Windows: Edit `%APPDATA%\Claude\claude_desktop_config.json`
202
214
 
203
- ### Integration with Claude for Desktop
215
+ 3. **Add the server configuration**:
204
216
 
205
- To integrate this server with Claude for Desktop:
217
+ **Using uvx (Recommended - No installation needed)**:
218
+ ```json
219
+ {
220
+ "mcpServers": {
221
+ "yfinance": {
222
+ "command": "uvx",
223
+ "args": ["yfin-mcp"]
224
+ }
225
+ }
226
+ }
227
+ ```
206
228
 
207
- 1. Install Claude for Desktop to your local machine.
208
- 2. Install VS Code to your local machine. Then run the following command to open the `claude_desktop_config.json` file:
209
- - MacOS: `code ~/Library/Application\ Support/Claude/claude_desktop_config.json`
210
- - Windows: `code $env:AppData\Claude\claude_desktop_config.json`
229
+ **Using Python directly (if installed via pip)**:
230
+ ```json
231
+ {
232
+ "mcpServers": {
233
+ "yfinance": {
234
+ "command": "python",
235
+ "args": ["-m", "yfin_mcp"]
236
+ }
237
+ }
238
+ }
239
+ ```
211
240
 
212
- 3. Edit the Claude for Desktop config file, located at:
213
- - macOS:
241
+ **For development/source installation**:
242
+ - macOS:
214
243
  ```json
215
244
  {
216
245
  "mcpServers": {
@@ -218,7 +247,7 @@ To integrate this server with Claude for Desktop:
218
247
  "command": "uv",
219
248
  "args": [
220
249
  "--directory",
221
- "/ABSOLUTE/PATH/TO/PARENT/FOLDER/yahoo-finance-mcp",
250
+ "/ABSOLUTE/PATH/TO/yahoo-finance-mcp",
222
251
  "run",
223
252
  "server.py"
224
253
  ]
@@ -234,7 +263,7 @@ To integrate this server with Claude for Desktop:
234
263
  "command": "uv",
235
264
  "args": [
236
265
  "--directory",
237
- "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\yahoo-finance-mcp",
266
+ "C:\\ABSOLUTE\\PATH\\TO\\yahoo-finance-mcp",
238
267
  "run",
239
268
  "server.py"
240
269
  ]
@@ -243,9 +272,50 @@ To integrate this server with Claude for Desktop:
243
272
  }
244
273
  ```
245
274
 
246
- - **Note**: You may need to put the full path to the uv executable in the command field. You can get this by running `which uv` on MacOS/Linux or `where uv` on Windows.
275
+ 4. **Restart Claude for Desktop**
276
+
277
+ ### Development Mode
278
+
279
+ For testing with MCP Inspector:
280
+
281
+ ```bash
282
+ # From source
283
+ uv run server.py
284
+
285
+ # Or if installed via pip
286
+ python -m yfin_mcp
287
+ ```
288
+
289
+ ## Publishing to PyPI
290
+
291
+ To build and publish the package, use the provided scripts. You can optionally provide an argument to bump the version:
292
+
293
+ ### Windows
294
+ ```bash
295
+ # Just build and publish current version
296
+ publish_package.bat
297
+
298
+ # Bump version and then publish
299
+ publish_package.bat patch
300
+ publish_package.bat minor
301
+ publish_package.bat major
302
+ ```
303
+
304
+ ### macOS/Linux
305
+ ```bash
306
+ chmod +x publish_package.sh
307
+
308
+ # Just build and publish current version
309
+ ./publish_package.sh
310
+
311
+ # Bump version and then publish
312
+ ./publish_package.sh patch
313
+ ./publish_package.sh minor
314
+ ./publish_package.sh major
315
+ ```
247
316
 
248
- 4. Restart Claude for Desktop
317
+ > [!NOTE]
318
+ > The scripts will build the package into the `dist/` directory and then use `uv publish` to upload it. Ensure you have your PyPI credentials configured in `~/.pypirc` (or `%HOME%\.pypirc` on Windows) or set the `UV_PUBLISH_TOKEN` environment variable.
249
319
 
250
320
  ## License
251
321
 
@@ -4,5 +4,6 @@ pyproject.toml
4
4
  yfin_mcp.egg-info/PKG-INFO
5
5
  yfin_mcp.egg-info/SOURCES.txt
6
6
  yfin_mcp.egg-info/dependency_links.txt
7
+ yfin_mcp.egg-info/entry_points.txt
7
8
  yfin_mcp.egg-info/requires.txt
8
9
  yfin_mcp.egg-info/top_level.txt
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ yfin-mcp = server:main
File without changes
File without changes