mseep-mcp-server 0.1.0__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.
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Financial Datasets
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.
@@ -0,0 +1,123 @@
1
+ Metadata-Version: 2.4
2
+ Name: mseep-mcp-server
3
+ Version: 0.1.0
4
+ Summary: Add your description here
5
+ Home-page:
6
+ Author: mseep
7
+ Author-email: support@skydeck.ai
8
+ Requires-Python: >=3.6
9
+ Description-Content-Type: text/markdown
10
+ License-File: LICENSE
11
+ Requires-Dist: httpx>=0.28.1
12
+ Requires-Dist: mcp[cli]>=1.3.0
13
+ Dynamic: author
14
+ Dynamic: author-email
15
+ Dynamic: license-file
16
+ Dynamic: requires-python
17
+
18
+ # Financial Datasets MCP Server
19
+
20
+ ## Introduction
21
+
22
+ This is a Model Context Protocol (MCP) server that provides access to stock market data from [Financial Datasets](https://www.financialdatasets.ai/).
23
+
24
+ It allows Claude and other AI assistants to retrieve income statements, balance sheets, cash flow statements, stock prices, and market news directly through the MCP interface.
25
+
26
+ ## Available Tools
27
+
28
+ This MCP server provides the following tools:
29
+
30
+ - **get_income_statements**: Retrieve income statements for a stock
31
+ - **get_balance_sheets**: Retrieve balance sheets for stock
32
+ - **get_cash_flow_statements**: Retrieve cash flow statements for a stock
33
+ - **get_current_price**: Get the latest price information for a stock
34
+ - **get_prices**: Get historical stock prices with customizable date ranges and intervals
35
+ - **get_news**: Get the latest news for a stock
36
+
37
+ ## Setup
38
+
39
+ ### Prerequisites
40
+
41
+ - Python 3.10 or higher
42
+ - [uv](https://github.com/astral-sh/uv) package manager
43
+
44
+ ### Installation
45
+
46
+ 1. Clone this repository:
47
+ ```bash
48
+ git clone https://github.com/financial-datasets/mcp-server
49
+ cd mcp-server
50
+ ```
51
+
52
+ 2. If you don't have uv installed, install it:
53
+ ```bash
54
+ # macOS/Linux
55
+ curl -LsSf https://astral.sh/uv/install.sh | sh
56
+
57
+ # Windows
58
+ curl -LsSf https://astral.sh/uv/install.ps1 | powershell
59
+ ```
60
+
61
+ 3. Install dependencies:
62
+ ```bash
63
+ # Create virtual env and activate it
64
+ uv venv
65
+ source .venv/bin/activate # On Windows: .venv\Scripts\activate
66
+
67
+ # Install dependencies
68
+ uv add "mcp[cli]" httpx # On Windows: uv add mcp[cli] httpx
69
+
70
+ ```
71
+
72
+ 4. Set up environment variables:
73
+ ```bash
74
+ # Create .env file for your API keys
75
+ cp .env.example .env
76
+
77
+ # Set API key in .env
78
+ FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key
79
+ ```
80
+
81
+ 5. Run the server:
82
+ ```bash
83
+ uv run server.py
84
+ ```
85
+
86
+ ## Connecting to Claude Desktop
87
+
88
+ 1. Install [Claude Desktop](https://claude.ai/desktop) if you haven't already
89
+
90
+ 2. Create or edit the Claude Desktop configuration file:
91
+ ```bash
92
+ # macOS
93
+ mkdir -p ~/Library/Application\ Support/Claude/
94
+ nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
95
+ ```
96
+
97
+ 3. Add the following configuration:
98
+ ```json
99
+ {
100
+ "mcpServers": {
101
+ "financial-datasets": {
102
+ "command": "/path/to/uv",
103
+ "args": [
104
+ "--directory",
105
+ "/absolute/path/to/financial-datasets-mcp",
106
+ "run",
107
+ "server.py"
108
+ ]
109
+ }
110
+ }
111
+ }
112
+ ```
113
+
114
+ Replace `/path/to/uv` with the result of `which uv` and `/absolute/path/to/financial-datasets-mcp` with the absolute path to this project.
115
+
116
+ 4. Restart Claude Desktop
117
+
118
+ 5. You should now see the financial tools available in Claude Desktop's tools menu (hammer icon)
119
+
120
+ 6. Try asking Claude questions like:
121
+ - "What are Apple's recent income statements?"
122
+ - "Show me the current price of Tesla stock"
123
+ - "Get historical prices for MSFT from 2024-01-01 to 2024-12-31"
@@ -0,0 +1,106 @@
1
+ # Financial Datasets MCP Server
2
+
3
+ ## Introduction
4
+
5
+ This is a Model Context Protocol (MCP) server that provides access to stock market data from [Financial Datasets](https://www.financialdatasets.ai/).
6
+
7
+ It allows Claude and other AI assistants to retrieve income statements, balance sheets, cash flow statements, stock prices, and market news directly through the MCP interface.
8
+
9
+ ## Available Tools
10
+
11
+ This MCP server provides the following tools:
12
+
13
+ - **get_income_statements**: Retrieve income statements for a stock
14
+ - **get_balance_sheets**: Retrieve balance sheets for stock
15
+ - **get_cash_flow_statements**: Retrieve cash flow statements for a stock
16
+ - **get_current_price**: Get the latest price information for a stock
17
+ - **get_prices**: Get historical stock prices with customizable date ranges and intervals
18
+ - **get_news**: Get the latest news for a stock
19
+
20
+ ## Setup
21
+
22
+ ### Prerequisites
23
+
24
+ - Python 3.10 or higher
25
+ - [uv](https://github.com/astral-sh/uv) package manager
26
+
27
+ ### Installation
28
+
29
+ 1. Clone this repository:
30
+ ```bash
31
+ git clone https://github.com/financial-datasets/mcp-server
32
+ cd mcp-server
33
+ ```
34
+
35
+ 2. If you don't have uv installed, install it:
36
+ ```bash
37
+ # macOS/Linux
38
+ curl -LsSf https://astral.sh/uv/install.sh | sh
39
+
40
+ # Windows
41
+ curl -LsSf https://astral.sh/uv/install.ps1 | powershell
42
+ ```
43
+
44
+ 3. Install dependencies:
45
+ ```bash
46
+ # Create virtual env and activate it
47
+ uv venv
48
+ source .venv/bin/activate # On Windows: .venv\Scripts\activate
49
+
50
+ # Install dependencies
51
+ uv add "mcp[cli]" httpx # On Windows: uv add mcp[cli] httpx
52
+
53
+ ```
54
+
55
+ 4. Set up environment variables:
56
+ ```bash
57
+ # Create .env file for your API keys
58
+ cp .env.example .env
59
+
60
+ # Set API key in .env
61
+ FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key
62
+ ```
63
+
64
+ 5. Run the server:
65
+ ```bash
66
+ uv run server.py
67
+ ```
68
+
69
+ ## Connecting to Claude Desktop
70
+
71
+ 1. Install [Claude Desktop](https://claude.ai/desktop) if you haven't already
72
+
73
+ 2. Create or edit the Claude Desktop configuration file:
74
+ ```bash
75
+ # macOS
76
+ mkdir -p ~/Library/Application\ Support/Claude/
77
+ nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
78
+ ```
79
+
80
+ 3. Add the following configuration:
81
+ ```json
82
+ {
83
+ "mcpServers": {
84
+ "financial-datasets": {
85
+ "command": "/path/to/uv",
86
+ "args": [
87
+ "--directory",
88
+ "/absolute/path/to/financial-datasets-mcp",
89
+ "run",
90
+ "server.py"
91
+ ]
92
+ }
93
+ }
94
+ }
95
+ ```
96
+
97
+ Replace `/path/to/uv` with the result of `which uv` and `/absolute/path/to/financial-datasets-mcp` with the absolute path to this project.
98
+
99
+ 4. Restart Claude Desktop
100
+
101
+ 5. You should now see the financial tools available in Claude Desktop's tools menu (hammer icon)
102
+
103
+ 6. Try asking Claude questions like:
104
+ - "What are Apple's recent income statements?"
105
+ - "Show me the current price of Tesla stock"
106
+ - "Get historical prices for MSFT from 2024-01-01 to 2024-12-31"
@@ -0,0 +1,123 @@
1
+ Metadata-Version: 2.4
2
+ Name: mseep-mcp-server
3
+ Version: 0.1.0
4
+ Summary: Add your description here
5
+ Home-page:
6
+ Author: mseep
7
+ Author-email: support@skydeck.ai
8
+ Requires-Python: >=3.6
9
+ Description-Content-Type: text/markdown
10
+ License-File: LICENSE
11
+ Requires-Dist: httpx>=0.28.1
12
+ Requires-Dist: mcp[cli]>=1.3.0
13
+ Dynamic: author
14
+ Dynamic: author-email
15
+ Dynamic: license-file
16
+ Dynamic: requires-python
17
+
18
+ # Financial Datasets MCP Server
19
+
20
+ ## Introduction
21
+
22
+ This is a Model Context Protocol (MCP) server that provides access to stock market data from [Financial Datasets](https://www.financialdatasets.ai/).
23
+
24
+ It allows Claude and other AI assistants to retrieve income statements, balance sheets, cash flow statements, stock prices, and market news directly through the MCP interface.
25
+
26
+ ## Available Tools
27
+
28
+ This MCP server provides the following tools:
29
+
30
+ - **get_income_statements**: Retrieve income statements for a stock
31
+ - **get_balance_sheets**: Retrieve balance sheets for stock
32
+ - **get_cash_flow_statements**: Retrieve cash flow statements for a stock
33
+ - **get_current_price**: Get the latest price information for a stock
34
+ - **get_prices**: Get historical stock prices with customizable date ranges and intervals
35
+ - **get_news**: Get the latest news for a stock
36
+
37
+ ## Setup
38
+
39
+ ### Prerequisites
40
+
41
+ - Python 3.10 or higher
42
+ - [uv](https://github.com/astral-sh/uv) package manager
43
+
44
+ ### Installation
45
+
46
+ 1. Clone this repository:
47
+ ```bash
48
+ git clone https://github.com/financial-datasets/mcp-server
49
+ cd mcp-server
50
+ ```
51
+
52
+ 2. If you don't have uv installed, install it:
53
+ ```bash
54
+ # macOS/Linux
55
+ curl -LsSf https://astral.sh/uv/install.sh | sh
56
+
57
+ # Windows
58
+ curl -LsSf https://astral.sh/uv/install.ps1 | powershell
59
+ ```
60
+
61
+ 3. Install dependencies:
62
+ ```bash
63
+ # Create virtual env and activate it
64
+ uv venv
65
+ source .venv/bin/activate # On Windows: .venv\Scripts\activate
66
+
67
+ # Install dependencies
68
+ uv add "mcp[cli]" httpx # On Windows: uv add mcp[cli] httpx
69
+
70
+ ```
71
+
72
+ 4. Set up environment variables:
73
+ ```bash
74
+ # Create .env file for your API keys
75
+ cp .env.example .env
76
+
77
+ # Set API key in .env
78
+ FINANCIAL_DATASETS_API_KEY=your-financial-datasets-api-key
79
+ ```
80
+
81
+ 5. Run the server:
82
+ ```bash
83
+ uv run server.py
84
+ ```
85
+
86
+ ## Connecting to Claude Desktop
87
+
88
+ 1. Install [Claude Desktop](https://claude.ai/desktop) if you haven't already
89
+
90
+ 2. Create or edit the Claude Desktop configuration file:
91
+ ```bash
92
+ # macOS
93
+ mkdir -p ~/Library/Application\ Support/Claude/
94
+ nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
95
+ ```
96
+
97
+ 3. Add the following configuration:
98
+ ```json
99
+ {
100
+ "mcpServers": {
101
+ "financial-datasets": {
102
+ "command": "/path/to/uv",
103
+ "args": [
104
+ "--directory",
105
+ "/absolute/path/to/financial-datasets-mcp",
106
+ "run",
107
+ "server.py"
108
+ ]
109
+ }
110
+ }
111
+ }
112
+ ```
113
+
114
+ Replace `/path/to/uv` with the result of `which uv` and `/absolute/path/to/financial-datasets-mcp` with the absolute path to this project.
115
+
116
+ 4. Restart Claude Desktop
117
+
118
+ 5. You should now see the financial tools available in Claude Desktop's tools menu (hammer icon)
119
+
120
+ 6. Try asking Claude questions like:
121
+ - "What are Apple's recent income statements?"
122
+ - "Show me the current price of Tesla stock"
123
+ - "Get historical prices for MSFT from 2024-01-01 to 2024-12-31"
@@ -0,0 +1,9 @@
1
+ LICENSE
2
+ README.md
3
+ pyproject.toml
4
+ setup.py
5
+ mseep_mcp_server.egg-info/PKG-INFO
6
+ mseep_mcp_server.egg-info/SOURCES.txt
7
+ mseep_mcp_server.egg-info/dependency_links.txt
8
+ mseep_mcp_server.egg-info/requires.txt
9
+ mseep_mcp_server.egg-info/top_level.txt
@@ -0,0 +1,2 @@
1
+ httpx>=0.28.1
2
+ mcp[cli]>=1.3.0
@@ -0,0 +1,17 @@
1
+ [project]
2
+ name = "mseep-mcp-server"
3
+ version = "0.1.0"
4
+ description = "Add your description here"
5
+ readme = "README.md"
6
+ requires-python = ">=3.11"
7
+ dependencies = [
8
+ "httpx>=0.28.1",
9
+ "mcp[cli]>=1.3.0",
10
+ ]
11
+
12
+ [build-system]
13
+ requires = [
14
+ "setuptools>=42",
15
+ "wheel",
16
+ ]
17
+ build-backend = "setuptools.build_meta"
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
@@ -0,0 +1,20 @@
1
+
2
+ from setuptools import setup, find_packages
3
+
4
+ setup(
5
+ name="mseep-mcp-server",
6
+ version="0.1.0",
7
+ description="Add your description here",
8
+ author="mseep",
9
+ author_email="support@skydeck.ai",
10
+ url="",
11
+ packages=find_packages(),
12
+ classifiers=[
13
+ "Programming Language :: Python :: 3",
14
+ "License :: OSI Approved :: MIT License",
15
+ "Operating System :: OS Independent",
16
+ ],
17
+ python_requires=">=3.6",
18
+ install_requires=['httpx>=0.28.1', 'mcp[cli]>=1.3.0'],
19
+ keywords=["mseep"] + [],
20
+ )