io.github.FreyaBit/shanghai-library-open-data-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SLC_API_KEY | No | 上海图书馆开放数据平台的 APIKey，用于调用需要 Key 的工具。优先级低于工具参数 key，但推荐配置在环境变量中。 |
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 | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| slc_eraA | 中国历史纪年表：输入朝代/年号返回公元年范围，或反之。例：明 -> 1368~1644。请传入 key（自己的上海图书馆开放数据 APIKey）。 |
| slc_jiapuB | 家谱谱目检索（data1）。可按谱名/姓氏检索 |
| slc_buildingC | 武康路历史建筑检索（已验证可用） |
| slc_red_eventC | 红色旅游/历史事件检索 |
| slc_apiA | 通用分发器：调用 api_2025 注册的全部 webapi 接口（家谱/古籍/盛档/人名库/碑帖/电影/期刊/舆图/书目/地名志/武康路 等 97 个）。endpoint 填接口 id；params 填查询参数(JSON)；path_args 填路径占位{0}{1}；key 填自己的上海图书馆开放数据 APIKey（必填）。先用 slc_endpoints 查 id。 |
| slc_endpointsA | 列出全部可用 webapi 接口（id/家族/路径/参数），可按 family 过滤。用于发现能力。 |
| slc_datasetsB | 数据集与第三方机构总览 |
| slc_sparqlC | SPARQL 图查询说明（该平台 Key 仅网页端可用） |
| slc_rawA | 任意 data1.library.sh.cn 路径的 GET 兜底调用 |
| souyun_poemA | 搜韵诗词检索（免token）：按作者/标题/诗句/朝代/体裁/韵部查诗词，服务 AIGC 歌词。 |
| souyun_rhymeA | 搜韵韵典：查字所属韵部、词末/词首典故、句末诗例（免token） |
| souyun_coupletA | 搜韵对仗词汇：返回与输入字/词对仗的词汇（免token），写对仗句用 |
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 12 tools
Most tools have distinct purposes (e.g., souyun_rhyme vs souyun_couplet), but slc_api and slc_raw both provide generic access to library data, and slc_sparql is documentation rather than a query tool. This creates some boundary confusion.
All names use lowercase with underscores and follow a prefix_noun pattern (souyun_* and slc_*). The convention is consistent, though not verb-noun based, and the mix of prefixes is acceptable.
12 tools is within the typical well-scoped range, but includes a few near-redundant access methods (slc_api, slc_raw, slc_endpoints) and a documentation-only tool (slc_sparql). Slightly heavy but reasonable for the combined library/poetry scope.
The library domain is nearly complete thanks to the generic slc_api dispatcher covering 97 endpoints, plus dedicated tools for key resources. The poetry tools cover rhyme, couplet, and poem search. Minor gaps exist (e.g., no direct SPARQL execution), but agents can work around them.