yfin-mcp 0.1.0__py3-none-any.whl → 0.2.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.
@@ -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
 
@@ -0,0 +1,6 @@
1
+ yfin_mcp-0.2.4.dist-info/licenses/LICENSE,sha256=-X17dvA84FUO-t9DRgqDt7JO2d0tSz6UpuZ-ZMtFfyo,1189
2
+ yfin_mcp-0.2.4.dist-info/METADATA,sha256=Y_1DaBQxoCpacFq7fFk1oszgDPzPaZBzxsKgQjm_54I,10778
3
+ yfin_mcp-0.2.4.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
4
+ yfin_mcp-0.2.4.dist-info/entry_points.txt,sha256=kpA80BnCqljODfRYZKgWGPco5SvNVQ1zJgQgpm5zz7k,41
5
+ yfin_mcp-0.2.4.dist-info/top_level.txt,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
6
+ yfin_mcp-0.2.4.dist-info/RECORD,,
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ yfin-mcp = server:main
@@ -1,5 +0,0 @@
1
- yfin_mcp-0.1.0.dist-info/licenses/LICENSE,sha256=-X17dvA84FUO-t9DRgqDt7JO2d0tSz6UpuZ-ZMtFfyo,1189
2
- yfin_mcp-0.1.0.dist-info/METADATA,sha256=D64yHatXMNLB7ouW_dQPmbJo5OUPNFjQsuXn9xnkRvk,9604
3
- yfin_mcp-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
4
- yfin_mcp-0.1.0.dist-info/top_level.txt,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
5
- yfin_mcp-0.1.0.dist-info/RECORD,,