smppw-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PPW_TOKEN | No | 登录态 http_tK_cache 的值，用于查询净值与业绩。可通过 set_token 工具保存到 ~/.ppw-mcp.json，或设置此环境变量。 | |
| PYTHONIOENCODING | No | Python IO 编码，设置为 utf-8。 | utf-8 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| set_tokenA | 保存排排网登录态（浏览器 cookie 中 http_tK_cache 的值）。 获取方法：浏览器登录 simuwang.com 后，F12 -> 应用 -> Cookie -> 找到 http_tK_cache，复制其值传入。保存到 ~/.ppw-mcp.json， 过期后重新登录再更新一次即可。 |
| check_authB | 验证排排网登录态是否有效（合格投资者数据是否解锁）。 |
| search_fundsA | 按名称搜索私募基金，返回 fund_id、公司、经理、成立日、 今年/成立以来收益、最大回撤等摘要。后续用 get_fund 查详情。 |
| search_companiesC | 按名称搜索私募公司，返回 company_id 与基本信息。 |
| get_rankingB | 获取私募排行榜（默认近半年收益排序，每页 50 条，共约 3460 只 可翻页）。每条含 fund_id、期末净值 nav、成立来/今年/近半年~近五年 各期收益，可直接用作基金当前单位净值来源。 |
| get_fundA | 查询基金详情（fund_id 形如 HF0000DEHO，可先用 search_funds 检索）。 返回当前净值 nav（含净值日期、今年以来/成立以来收益）、基本信息 （策略、成立日、开放日、托管人、备案号、投资范围）、管理公司与经理。 nav 为 None 表示该基金未进排行榜（站方对详情页净值做了图片化）。 |
| get_fund_performanceC | 查询基金当前指标与区间业绩汇总（净值日期、收益/回撤/夏普等指标， 以及成立来/今年/近一月~近五年各区间收益与基准对照、同类排名）。 |
| get_fund_returnsB | 查询基金收益序列（数据来自 sppwapi performanceRangeV2，明文可解）。 granularity: monthly=月度收益序列 | quarterly=季度 | yearly=年度 （含基准对照；年度还含同类排名与四分位）。 配合初始净值 1.0 可合成累计净值走势。 |
| get_fund_asset_sizeC | 查询基金规模变动序列（各期规模与环比变化）。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Most tools target distinct actions (search, ranking, detail, series). However get_fund, get_fund_performance, and get_fund_returns all return overlapping return/nav data, and get_ranking also surfaces nav, so an agent could pick the wrong one for a given data need.
Consistent snake_case verb_noun pattern throughout: set_token, check_auth, search_funds, get_fund, get_fund_performance, get_fund_returns, get_fund_asset_size. The get_fund_* family is predictable and readable.
9 tools is well-scoped for a fund-data API: auth pair plus search and detail/series endpoints. Each tool earns its place with no redundancy padding.
Fund lifecycle is well covered (search → detail → performance → returns → asset size). Minor gap: search_companies returns a company_id but there is no get_company detail tool, creating a dead end for company lookups.