内容
# smallcase-mcp
> # ⚠️ 非官方 — 这不是官方的 smallcase MCP
>
> 这是一个**独立的、社区建设的**项目。它**不是**由 **smallcase** 构建、授权、认可、赞助或支持的，它**不是**“smallcase MCP”，并且它使用**没有官方 smallcase API**。“smallcase” 是其各自所有者的商标。它读取 smallcase 的**公共网站端点**（不是官方的 [smallcase Gateway](https://developers.gateway.smallcase.com) API），这些端点可能会随时更改或中断。仅供信息/研究使用 — **不是投资建议**，并且不是官方数据源。某些数据（尤其是**过去的收益**）在 smallcase 的自己的 UI 中显示在同意步骤后面（“根据适用的指南”）；请自行判断。所有数据 © smallcase 和各自的发布者。
一个 **只读** 的 [MCP](https://modelcontextprotocol.io) 服务器，暴露 smallcase 的**公共**发现数据 — 已发布的 smallcase 目录、它们的收益、风险指标、基本原理、再平衡计划，以及股票、共同基金和精选集合 — 给任何 LLM 或代理（Claude Desktop、Claude Code、Cursor、…）。
无需 API 密钥。无需浏览器。无需登录。只需通过公共 smallcase.com 网站已经为注销访客调用的端点的干净 HTTP。
## 功能
| ✅ 可用（公共） | ❌ 不可用（由 smallcase 控制） |
|---|---|
| 搜索/列出已发布的 smallcase 目录 | 成分 / 持仓 + 权重 |
| 复利增长率，收益（1 天 → 5 年，自成立以来） | 再平衡 *成分历史* |
| 风险指标（波动性，夏普比率，贝塔值，市值分割，52 周高/低） | 您的个人投资组合 / 投资 |
| 最低投资额，月度订阅价格 | 下单 / 任何交易 |
| 基本原理，再平衡 *计划*，发布者信息 | |
## 工具
| 工具 | 描述 |
|---|---|
| `search_smallcases(query, volatility, min_amount, max_amount, sort, limit, include_private)` | 搜索/筛选已发布的 smallcase。文本匹配名称/描述/发布者，`volatility` = 低/中/高，最小/最大投资，`sort` = 流行度 \| 最小金额 \| 收益 \| 最近再平衡。`include_private=true` 还会显示 **关闭新投资者** （标记为 `private`）的计划，smallcase 从公共发现中隐藏了这些计划。 |
| `get_smallcase(scid)` | 通过 SCID（例如 `SCET_0005`）获取一个 smallcase 的完整详细信息：收益、风险、基本原理、方法和 `flags`（活动 / 阻止 / 私有）。如果您知道 SCID，也适用于私有计划。 |
| `compare_smallcases(scids)` | 2-5 个 smallcase 的并排比较（收益 / 风险 / 最低投资）。 |
| `get_rebalance_schedule(scid)` | Smallcase 的再平衡节奏和上一次/下一次再平衡日期。 |
| `list_managers(page, page_size)` | 列出 smallcase 发布者 / 研究机构。 |
| `search_stocks(query, limit)` | 在 smallcase 的公共宇宙中搜索股票（名称 / 代号 / 行业）。 |
| `search_mutual_funds(query, limit)` | 搜索共同基金（名称 / 资产管理公司 / 类别）。 |
| `list_collections(query, limit)` | 列出精选的 smallcase 集合（主题分组）。 |
连接后示例提示： *"查找低波动性黄金 smallcase，价值 ₹5000 以下"*， *"比较 SCET_0005 和按收益排名最高的 smallcase"*， *"SCET_0005 背后的基本原理是什么？"*， *"SCET_0005 何时再次平衡？"*， *"搜索银行股票"*， *"显示我能源共同基金"*。
## 安装
该软件包位于 [PyPI](https://pypi.org/project/smallcase-mcp/) — 无需克隆，无需路径，无需 API 密钥。任何 MCP 客户端都可以使用 `uvx` 启动它。
### Claude Code （一行命令）
```bash
claude mcp add -s user smallcase -- uvx smallcase-mcp@latest
```
### Claude 桌面版
```json
{
"mcpServers": {
"smallcase": {
"command": "uvx",
"args": ["smallcase-mcp@latest"]
}
}
}
```
### 任何其他 MCP 客户端
将它指向_stdio_命令：
```bash
uvx smallcase-mcp
```
`@latest` 使 uvx 解析最新版本，而不是重用缓存版本。
## 开发
仅在您想自己修改服务器时需要：
```bash
git clone https://github.com/Pragadeesh122/smallcase-mcp.git
cd smallcase-mcp
uv sync
uv run python tests/test_live.py # live-API 检查
uv run python tests/test_mcp_protocol.py # 完整的 MCP 握手通过 stdio
```
在本地运行您的检查点作为服务器，而不是 PyPI 构建：
```bash
claude mcp add -s user smallcase -- uv --directory /path/to/smallcase-mcp run smallcase-mcp
```
## 技术栈
Python 3.11+ · [MCP Python SDK (FastMCP)](https://github.com/modelcontextprotocol/python-sdk) · `httpx`.
## 许可证
[MIT](LICENSE)。与 smallcase 无关。查看此文件的顶部和 LICENSE 中的通知。
