fipiran-mcp 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.
- fipiran_mcp-0.1.0/.github/workflows/ci.yml +22 -0
- fipiran_mcp-0.1.0/.github/workflows/publish.yml +51 -0
- fipiran_mcp-0.1.0/.gitignore +6 -0
- fipiran_mcp-0.1.0/LICENSE +21 -0
- fipiran_mcp-0.1.0/PKG-INFO +88 -0
- fipiran_mcp-0.1.0/README.md +60 -0
- fipiran_mcp-0.1.0/pyproject.toml +56 -0
- fipiran_mcp-0.1.0/server.json +32 -0
- fipiran_mcp-0.1.0/src/fipiran_mcp/__init__.py +5 -0
- fipiran_mcp-0.1.0/src/fipiran_mcp/funds.py +398 -0
- fipiran_mcp-0.1.0/src/fipiran_mcp/http.py +226 -0
- fipiran_mcp-0.1.0/src/fipiran_mcp/market.py +331 -0
- fipiran_mcp-0.1.0/src/fipiran_mcp/registry.py +16 -0
- fipiran_mcp-0.1.0/src/fipiran_mcp/server.py +92 -0
- fipiran_mcp-0.1.0/tests/conftest.py +78 -0
- fipiran_mcp-0.1.0/tests/fixtures/averagereturns.json +1 -0
- fipiran_mcp-0.1.0/tests/fixtures/chart_nav.json +1 -0
- fipiran_mcp-0.1.0/tests/fixtures/chart_returns.json +1 -0
- fipiran_mcp-0.1.0/tests/fixtures/chart_size.json +1 -0
- fipiran_mcp-0.1.0/tests/fixtures/fundcompare.json +1 -0
- fipiran_mcp-0.1.0/tests/fixtures/fundcompare_mm.json +1 -0
- fipiran_mcp-0.1.0/tests/fixtures/fundprofitschart.json +1 -0
- fipiran_mcp-0.1.0/tests/fixtures/fundtype.json +1 -0
- fipiran_mcp-0.1.0/tests/fixtures/getefficiency.json +1 -0
- fipiran_mcp-0.1.0/tests/fixtures/getfund.json +1 -0
- fipiran_mcp-0.1.0/tests/fixtures/getindustry.json +1 -0
- fipiran_mcp-0.1.0/tests/fixtures/getinstrument.json +1 -0
- fipiran_mcp-0.1.0/tests/fixtures/indexcompare.json +1 -0
- fipiran_mcp-0.1.0/tests/fixtures/indexefficiencychart.json +1 -0
- fipiran_mcp-0.1.0/tests/fixtures/indexvaluechart.json +1 -0
- fipiran_mcp-0.1.0/tests/fixtures/industrychart.json +1 -0
- fipiran_mcp-0.1.0/tests/fixtures/instrumentcompare.json +1 -0
- fipiran_mcp-0.1.0/tests/fixtures/instrumenthistory.json +1 -0
- fipiran_mcp-0.1.0/tests/fixtures/marketlast.json +1 -0
- fipiran_mcp-0.1.0/tests/fixtures/possessionchart.json +1 -0
- fipiran_mcp-0.1.0/tests/test_fipiran.py +186 -0
- fipiran_mcp-0.1.0/tests/test_live_fipiran.py +45 -0
- fipiran_mcp-0.1.0/uv.lock +1362 -0
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
name: CI
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
branches: [main]
|
|
6
|
+
pull_request:
|
|
7
|
+
|
|
8
|
+
jobs:
|
|
9
|
+
test:
|
|
10
|
+
runs-on: ubuntu-latest
|
|
11
|
+
strategy:
|
|
12
|
+
matrix:
|
|
13
|
+
python: ["3.10", "3.11", "3.12", "3.13"]
|
|
14
|
+
steps:
|
|
15
|
+
- uses: actions/checkout@v7
|
|
16
|
+
- uses: astral-sh/setup-uv@v10.2.0
|
|
17
|
+
with:
|
|
18
|
+
python-version: ${{ matrix.python }}
|
|
19
|
+
- run: uv sync --locked
|
|
20
|
+
- run: uv run ruff check .
|
|
21
|
+
- run: uv run ruff format --check .
|
|
22
|
+
- run: uv run pytest -q
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
name: Publish
|
|
2
|
+
|
|
3
|
+
# Tag a release (git tag v0.1.0 && git push --tags) after bumping the version in
|
|
4
|
+
# pyproject.toml and server.json.
|
|
5
|
+
on:
|
|
6
|
+
push:
|
|
7
|
+
tags: ["v*"]
|
|
8
|
+
|
|
9
|
+
jobs:
|
|
10
|
+
pypi:
|
|
11
|
+
runs-on: ubuntu-latest
|
|
12
|
+
environment: pypi
|
|
13
|
+
permissions:
|
|
14
|
+
id-token: write # PyPI trusted publishing
|
|
15
|
+
contents: write # GitHub Release
|
|
16
|
+
steps:
|
|
17
|
+
- uses: actions/checkout@v7
|
|
18
|
+
- uses: astral-sh/setup-uv@v10.2.0
|
|
19
|
+
- name: Check versions match the tag
|
|
20
|
+
run: |
|
|
21
|
+
TAG=${GITHUB_REF_NAME#v}
|
|
22
|
+
grep -q "^version = \"$TAG\"" pyproject.toml
|
|
23
|
+
test "$(jq -r .version server.json)" = "$TAG"
|
|
24
|
+
test "$(jq -r '.packages[0].version' server.json)" = "$TAG"
|
|
25
|
+
- run: uv sync --locked && uv run pytest -q
|
|
26
|
+
- run: uv build
|
|
27
|
+
- uses: pypa/gh-action-pypi-publish@release/v1
|
|
28
|
+
- run: gh release create "$GITHUB_REF_NAME" dist/* --generate-notes --title "$GITHUB_REF_NAME"
|
|
29
|
+
env:
|
|
30
|
+
GH_TOKEN: ${{ github.token }}
|
|
31
|
+
|
|
32
|
+
mcp-registry:
|
|
33
|
+
needs: pypi
|
|
34
|
+
runs-on: ubuntu-latest
|
|
35
|
+
permissions:
|
|
36
|
+
id-token: write # MCP Registry login via GitHub OIDC
|
|
37
|
+
contents: read
|
|
38
|
+
steps:
|
|
39
|
+
- uses: actions/checkout@v7
|
|
40
|
+
- name: Wait for PyPI to serve the new version
|
|
41
|
+
run: |
|
|
42
|
+
for i in $(seq 1 30); do
|
|
43
|
+
curl -sf "https://pypi.org/pypi/fipiran-mcp/${GITHUB_REF_NAME#v}/json" >/dev/null && exit 0
|
|
44
|
+
sleep 10
|
|
45
|
+
done
|
|
46
|
+
exit 1
|
|
47
|
+
- name: Install mcp-publisher
|
|
48
|
+
run: |
|
|
49
|
+
curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.8.1/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
|
|
50
|
+
- run: ./mcp-publisher login github-oidc
|
|
51
|
+
- run: ./mcp-publisher publish
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Sepehr Radmard
|
|
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,88 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: fipiran-mcp
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: Unofficial read-only MCP server for Fipiran (fipiran.ir): Iranian mutual funds and ETFs, NAV, returns, size, managers.
|
|
5
|
+
Project-URL: Homepage, https://github.com/sepehr071/fipiran-mcp
|
|
6
|
+
Project-URL: Issues, https://github.com/sepehr071/fipiran-mcp/issues
|
|
7
|
+
Project-URL: Website, https://mcpfarsi.ir/
|
|
8
|
+
Author-email: Sepehr Radmard <sepehrr80@gmail.com>
|
|
9
|
+
License-Expression: MIT
|
|
10
|
+
License-File: LICENSE
|
|
11
|
+
Keywords: claude,etf,fipiran,fund-returns,investment,iran,mcp,model-context-protocol,mutual-funds,nav,persian,tehran-stock-exchange,tse
|
|
12
|
+
Classifier: Development Status :: 4 - Beta
|
|
13
|
+
Classifier: Intended Audience :: Developers
|
|
14
|
+
Classifier: Operating System :: OS Independent
|
|
15
|
+
Classifier: Programming Language :: Python :: 3
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
20
|
+
Classifier: Topic :: Office/Business :: Financial :: Investment
|
|
21
|
+
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
|
|
22
|
+
Requires-Python: >=3.10
|
|
23
|
+
Requires-Dist: curl-cffi>=0.16.3
|
|
24
|
+
Requires-Dist: httpx-curl-cffi>=0.1.5
|
|
25
|
+
Requires-Dist: httpx>=0.27
|
|
26
|
+
Requires-Dist: mcp<3,>=2.2
|
|
27
|
+
Description-Content-Type: text/markdown
|
|
28
|
+
|
|
29
|
+
<!-- mcp-name: io.github.sepehr071/fipiran-mcp -->
|
|
30
|
+
|
|
31
|
+
# fipiran-mcp: Fipiran (فیپیران) Iranian mutual fund and ETF data MCP server for AI agents
|
|
32
|
+
|
|
33
|
+
**fipiran-mcp is an unofficial, read-only MCP server that gives AI agents the public fund data of Fipiran (مرکز پردازش اطلاعات مالی ایران, fipiran.ir).**<br>
|
|
34
|
+
Its 11 tools search and rank Iranian mutual funds and ETFs (صندوقهای سرمایهگذاری) by type, manager, size and return,<br>
|
|
35
|
+
show one fund in full, return daily NAV, return, size, flow and investor-mix history, compare funds, rank fund managers, and cover the bourse: market overview, indices, stock quotes and industries.
|
|
36
|
+
No API key or account is needed. It works in Claude, Cursor, Copilot and any other MCP client.
|
|
37
|
+
|
|
38
|
+
[](https://pypi.org/project/fipiran-mcp/)
|
|
39
|
+
[](https://github.com/sepehr071/fipiran-mcp/blob/main/LICENSE)
|
|
40
|
+
|
|
41
|
+
## For AI agents
|
|
42
|
+
|
|
43
|
+
- **What:** unofficial MCP server for fipiran.ir fund pages: search and ranking of about 500 Iranian mutual funds and ETFs, fund details, daily NAV / rolling-return / size history, side-by-side comparison, fund types with average returns, fund management companies.
|
|
44
|
+
- **Install:** `uvx fipiran-mcp` or `claude mcp add fipiran -- uvx fipiran-mcp`. Transport: stdio. Needs [uv](https://docs.astral.sh/uv/getting-started/installation/) (Python 3.10+).
|
|
45
|
+
- **Auth:** none. Optional `FIPIRAN_MCP_PROXY` (HTTP proxy URL); system proxy settings are ignored.
|
|
46
|
+
- **Network:** fipiran.ir answers **Iranian internet lines only**. Outside Iran, set `FIPIRAN_MCP_PROXY` to an Iranian proxy.
|
|
47
|
+
- **Access:** read-only, no confirmation needed. Login-only Fipiran features (ranking reports, watchlists, exports) are not included.
|
|
48
|
+
- **Tools:** 11, all prefixed `fp_`: `fp_search_funds`, `fp_fund_types`, `fp_fund`, `fp_history`, `fp_compare`, `fp_managers`, `fp_indices`, `fp_index_history`, `fp_stocks`, `fp_stock`, `fp_industries`. Typical sequence: `fp_search_funds` -> `fp_fund` / `fp_history` / `fp_compare`.
|
|
49
|
+
- **Use when:** the user asks which Iranian funds returned most, the biggest gold or fixed-income funds, the NAV or price history of a fund, how a fund compares with its type average, or who manages a fund.
|
|
50
|
+
- **Output:** compact JSON. Returns are percent per period (not annualised); sizes billion Toman; NAV rial per unit. Names are Persian.
|
|
51
|
+
|
|
52
|
+
## Tools
|
|
53
|
+
|
|
54
|
+
| Tool | What it does |
|
|
55
|
+
|---|---|
|
|
56
|
+
| `fp_search_funds` | Find and rank funds by name, ticker, type, manager, size, age and return (daily to since-start). |
|
|
57
|
+
| `fp_fund_types` | Fund types with fund count, total size, average returns and average asset allocation. |
|
|
58
|
+
| `fp_fund` | One fund in full: NAV, returns, size, allocation, investors, manager, auditor, custodian, website; optional past date. |
|
|
59
|
+
| `fp_history` | Daily NAV, rolling returns, net assets and unit flows, institutional/retail mix or dividends of one fund (up to 60 evenly spaced points). |
|
|
60
|
+
| `fp_compare` | 2 to 8 funds side by side. |
|
|
61
|
+
| `fp_managers` | Fund management companies by assets under management. |
|
|
62
|
+
| `fp_indices` | Tehran and Farabourse market overview plus the 65 market and industry indices ranked by return. |
|
|
63
|
+
| `fp_index_history` | Daily value (with low and high) or rolling returns of one index. |
|
|
64
|
+
| `fp_stocks` | Search and rank listed shares of the last trading day: gainers, losers, most traded, by industry or market. |
|
|
65
|
+
| `fp_stock` | One share in full: quote, range, 5-level order book, retail vs institutional, period returns, optional OHLC history. |
|
|
66
|
+
| `fp_industries` | Industries ranked by traded value, volume and trades on the last day. |
|
|
67
|
+
|
|
68
|
+
## Quick start
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
uvx fipiran-mcp
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
Claude Desktop / Cursor config:
|
|
75
|
+
|
|
76
|
+
```json
|
|
77
|
+
{ "mcpServers": { "fipiran": { "command": "uvx", "args": ["fipiran-mcp"] } } }
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
## FAQ
|
|
81
|
+
|
|
82
|
+
**Is it official?** No. It reads the same public JSON the fipiran.ir fund pages load; it is not affiliated with Fipiran.<br>
|
|
83
|
+
**Is this investment advice?** No. It is data. Past returns do not predict future returns; very young funds show distorted annual returns.<br>
|
|
84
|
+
**Why does it fail outside Iran?** The site does not answer foreign IPs. Use `FIPIRAN_MCP_PROXY`.
|
|
85
|
+
|
|
86
|
+
---
|
|
87
|
+
|
|
88
|
+
*Author: Sepehr Radmard (سپهر رادمرد), [github.com/sepehr071](https://github.com/sepehr071), [linkedin.com/in/sepehr-radmard](https://linkedin.com/in/sepehr-radmard). MIT license.*
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
<!-- mcp-name: io.github.sepehr071/fipiran-mcp -->
|
|
2
|
+
|
|
3
|
+
# fipiran-mcp: Fipiran (فیپیران) Iranian mutual fund and ETF data MCP server for AI agents
|
|
4
|
+
|
|
5
|
+
**fipiran-mcp is an unofficial, read-only MCP server that gives AI agents the public fund data of Fipiran (مرکز پردازش اطلاعات مالی ایران, fipiran.ir).**<br>
|
|
6
|
+
Its 11 tools search and rank Iranian mutual funds and ETFs (صندوقهای سرمایهگذاری) by type, manager, size and return,<br>
|
|
7
|
+
show one fund in full, return daily NAV, return, size, flow and investor-mix history, compare funds, rank fund managers, and cover the bourse: market overview, indices, stock quotes and industries.
|
|
8
|
+
No API key or account is needed. It works in Claude, Cursor, Copilot and any other MCP client.
|
|
9
|
+
|
|
10
|
+
[](https://pypi.org/project/fipiran-mcp/)
|
|
11
|
+
[](https://github.com/sepehr071/fipiran-mcp/blob/main/LICENSE)
|
|
12
|
+
|
|
13
|
+
## For AI agents
|
|
14
|
+
|
|
15
|
+
- **What:** unofficial MCP server for fipiran.ir fund pages: search and ranking of about 500 Iranian mutual funds and ETFs, fund details, daily NAV / rolling-return / size history, side-by-side comparison, fund types with average returns, fund management companies.
|
|
16
|
+
- **Install:** `uvx fipiran-mcp` or `claude mcp add fipiran -- uvx fipiran-mcp`. Transport: stdio. Needs [uv](https://docs.astral.sh/uv/getting-started/installation/) (Python 3.10+).
|
|
17
|
+
- **Auth:** none. Optional `FIPIRAN_MCP_PROXY` (HTTP proxy URL); system proxy settings are ignored.
|
|
18
|
+
- **Network:** fipiran.ir answers **Iranian internet lines only**. Outside Iran, set `FIPIRAN_MCP_PROXY` to an Iranian proxy.
|
|
19
|
+
- **Access:** read-only, no confirmation needed. Login-only Fipiran features (ranking reports, watchlists, exports) are not included.
|
|
20
|
+
- **Tools:** 11, all prefixed `fp_`: `fp_search_funds`, `fp_fund_types`, `fp_fund`, `fp_history`, `fp_compare`, `fp_managers`, `fp_indices`, `fp_index_history`, `fp_stocks`, `fp_stock`, `fp_industries`. Typical sequence: `fp_search_funds` -> `fp_fund` / `fp_history` / `fp_compare`.
|
|
21
|
+
- **Use when:** the user asks which Iranian funds returned most, the biggest gold or fixed-income funds, the NAV or price history of a fund, how a fund compares with its type average, or who manages a fund.
|
|
22
|
+
- **Output:** compact JSON. Returns are percent per period (not annualised); sizes billion Toman; NAV rial per unit. Names are Persian.
|
|
23
|
+
|
|
24
|
+
## Tools
|
|
25
|
+
|
|
26
|
+
| Tool | What it does |
|
|
27
|
+
|---|---|
|
|
28
|
+
| `fp_search_funds` | Find and rank funds by name, ticker, type, manager, size, age and return (daily to since-start). |
|
|
29
|
+
| `fp_fund_types` | Fund types with fund count, total size, average returns and average asset allocation. |
|
|
30
|
+
| `fp_fund` | One fund in full: NAV, returns, size, allocation, investors, manager, auditor, custodian, website; optional past date. |
|
|
31
|
+
| `fp_history` | Daily NAV, rolling returns, net assets and unit flows, institutional/retail mix or dividends of one fund (up to 60 evenly spaced points). |
|
|
32
|
+
| `fp_compare` | 2 to 8 funds side by side. |
|
|
33
|
+
| `fp_managers` | Fund management companies by assets under management. |
|
|
34
|
+
| `fp_indices` | Tehran and Farabourse market overview plus the 65 market and industry indices ranked by return. |
|
|
35
|
+
| `fp_index_history` | Daily value (with low and high) or rolling returns of one index. |
|
|
36
|
+
| `fp_stocks` | Search and rank listed shares of the last trading day: gainers, losers, most traded, by industry or market. |
|
|
37
|
+
| `fp_stock` | One share in full: quote, range, 5-level order book, retail vs institutional, period returns, optional OHLC history. |
|
|
38
|
+
| `fp_industries` | Industries ranked by traded value, volume and trades on the last day. |
|
|
39
|
+
|
|
40
|
+
## Quick start
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
uvx fipiran-mcp
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
Claude Desktop / Cursor config:
|
|
47
|
+
|
|
48
|
+
```json
|
|
49
|
+
{ "mcpServers": { "fipiran": { "command": "uvx", "args": ["fipiran-mcp"] } } }
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
## FAQ
|
|
53
|
+
|
|
54
|
+
**Is it official?** No. It reads the same public JSON the fipiran.ir fund pages load; it is not affiliated with Fipiran.<br>
|
|
55
|
+
**Is this investment advice?** No. It is data. Past returns do not predict future returns; very young funds show distorted annual returns.<br>
|
|
56
|
+
**Why does it fail outside Iran?** The site does not answer foreign IPs. Use `FIPIRAN_MCP_PROXY`.
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
*Author: Sepehr Radmard (سپهر رادمرد), [github.com/sepehr071](https://github.com/sepehr071), [linkedin.com/in/sepehr-radmard](https://linkedin.com/in/sepehr-radmard). MIT license.*
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
[project]
|
|
2
|
+
name = "fipiran-mcp"
|
|
3
|
+
version = "0.1.0"
|
|
4
|
+
description = "Unofficial read-only MCP server for Fipiran (fipiran.ir): Iranian mutual funds and ETFs, NAV, returns, size, managers."
|
|
5
|
+
readme = "README.md"
|
|
6
|
+
license = "MIT"
|
|
7
|
+
license-files = ["LICENSE"]
|
|
8
|
+
authors = [{ name = "Sepehr Radmard", email = "sepehrr80@gmail.com" }]
|
|
9
|
+
requires-python = ">=3.10"
|
|
10
|
+
keywords = ["mcp", "model-context-protocol", "fipiran", "iran", "mutual-funds", "etf", "nav", "tehran-stock-exchange", "tse", "fund-returns", "investment", "claude", "persian"]
|
|
11
|
+
classifiers = [
|
|
12
|
+
"Development Status :: 4 - Beta",
|
|
13
|
+
"Intended Audience :: Developers",
|
|
14
|
+
"Operating System :: OS Independent",
|
|
15
|
+
"Programming Language :: Python :: 3",
|
|
16
|
+
"Programming Language :: Python :: 3.10",
|
|
17
|
+
"Programming Language :: Python :: 3.11",
|
|
18
|
+
"Programming Language :: Python :: 3.12",
|
|
19
|
+
"Programming Language :: Python :: 3.13",
|
|
20
|
+
"Topic :: Scientific/Engineering :: Artificial Intelligence",
|
|
21
|
+
"Topic :: Office/Business :: Financial :: Investment",
|
|
22
|
+
]
|
|
23
|
+
dependencies = [
|
|
24
|
+
"mcp>=2.2,<3",
|
|
25
|
+
"httpx>=0.27",
|
|
26
|
+
"httpx-curl-cffi>=0.1.5",
|
|
27
|
+
"curl-cffi>=0.16.3",
|
|
28
|
+
]
|
|
29
|
+
|
|
30
|
+
[project.urls]
|
|
31
|
+
Homepage = "https://github.com/sepehr071/fipiran-mcp"
|
|
32
|
+
Issues = "https://github.com/sepehr071/fipiran-mcp/issues"
|
|
33
|
+
Website = "https://mcpfarsi.ir/"
|
|
34
|
+
|
|
35
|
+
[project.scripts]
|
|
36
|
+
fipiran-mcp = "fipiran_mcp.server:main"
|
|
37
|
+
|
|
38
|
+
[dependency-groups]
|
|
39
|
+
dev = ["pytest>=8", "ruff>=0.6"]
|
|
40
|
+
|
|
41
|
+
[build-system]
|
|
42
|
+
requires = ["hatchling"]
|
|
43
|
+
build-backend = "hatchling.build"
|
|
44
|
+
|
|
45
|
+
[tool.pytest.ini_options]
|
|
46
|
+
testpaths = ["tests"]
|
|
47
|
+
addopts = "-m 'not live'"
|
|
48
|
+
markers = ["live: calls the real Fipiran API (run with -m live)"]
|
|
49
|
+
|
|
50
|
+
[tool.ruff]
|
|
51
|
+
line-length = 120
|
|
52
|
+
target-version = "py310"
|
|
53
|
+
|
|
54
|
+
[tool.ruff.lint]
|
|
55
|
+
select = ["E", "F", "I", "B", "UP"]
|
|
56
|
+
ignore = ["E501"] # long Field(description=...) strings read better on one line
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
|
|
3
|
+
"name": "io.github.sepehr071/fipiran-mcp",
|
|
4
|
+
"title": "Fipiran Funds",
|
|
5
|
+
"description": "Read-only Fipiran (fipiran.ir) data on Iranian mutual funds and ETFs: NAV, returns, size, managers.",
|
|
6
|
+
"repository": {
|
|
7
|
+
"url": "https://github.com/sepehr071/fipiran-mcp",
|
|
8
|
+
"source": "github"
|
|
9
|
+
},
|
|
10
|
+
"websiteUrl": "https://github.com/sepehr071/fipiran-mcp",
|
|
11
|
+
"version": "0.1.0",
|
|
12
|
+
"packages": [
|
|
13
|
+
{
|
|
14
|
+
"registryType": "pypi",
|
|
15
|
+
"registryBaseUrl": "https://pypi.org",
|
|
16
|
+
"identifier": "fipiran-mcp",
|
|
17
|
+
"version": "0.1.0",
|
|
18
|
+
"runtimeHint": "uvx",
|
|
19
|
+
"transport": {
|
|
20
|
+
"type": "stdio"
|
|
21
|
+
},
|
|
22
|
+
"environmentVariables": [
|
|
23
|
+
{
|
|
24
|
+
"name": "FIPIRAN_MCP_PROXY",
|
|
25
|
+
"description": "Optional HTTP proxy URL for the Fipiran requests; system proxy settings are ignored. The site answers Iranian lines only.",
|
|
26
|
+
"isRequired": false,
|
|
27
|
+
"isSecret": false
|
|
28
|
+
}
|
|
29
|
+
]
|
|
30
|
+
}
|
|
31
|
+
]
|
|
32
|
+
}
|