sedis-ab

@sedis/mcp

这是一个 Model Context Protocol（MCP）服务，将 Sedis PartnerAPI v2 封装为一组精心整理的只读工具，让 AI 助手和 Agent（Claude Desktop、Cursor 以及任何支持 MCP 的客户端）能够用自然语言查询你的 Sedis Bolagsanalys（上市公司财务数据）和 Fastighetsbenchmark（房地产可比数据）。该服务只是一个轻量透传层：它只负责格式转换和传输；所有租户隔离、身份验证、速率限制和计费规则都由 PartnerAPI v2 负责，与本服务无关。

还不是 Sedis 客户？ 使用此服务需要 Sedis PartnerAPI v2 密钥——没有免费版或试用版。请联系我们： [email protected] · Fråga Sedis

安装

最简单：一键安装 Claude Desktop 套件（.mcpb）——推荐

对于非技术用户，请安装桌面扩展——只需一个文件，无需 Node、JSON 或终端：

1. 从最新版本下载 sedis-mcp.mcpb。
2. 双击它（或打开 Claude Desktop → Settings → Extensions 并将文件拖入），然后点击 Install。
3. 将你的 Sedis API 密钥粘贴到出现的字段中（密钥存储在操作系统的密钥链中），然后确认。
4. 完成——开始聊天并提出问题，例如 "Visa nyckeltal för Fabege"（瑞典语请使用 lang: "sv"）。

此套件将下文所述的确切服务及其依赖项打包在一起；Claude Desktop 会提供 Node 运行时，因此用户无需安装其他内容。请向 Sedis 管理员索取密钥——客户级（M2M）密钥无需每次会话进行双重验证。维护者使用 npm run build:mcpb 构建套件（输出：dist/sedis-mcp.mcpb）。

手动配置（适用于任何 MCP 客户端——Claude Code、Cursor 等）

该服务通过 stdio 运行，并按需通过 npx 启动——无需全局安装。标准启动命令为：

npx -y @sedis/mcp

将其添加到客户端的 MCP 配置中，并设置你的 PartnerAPI 密钥：

{
  "mcpServers": {
    "sedis": {
      "command": "npx",
      "args": ["-y", "@sedis/mcp"],
      "env": {
        "SEDIS_API_KEY": "your-partnerapi-v2-key"
      }
    }
  }
}

• Claude Desktop： 将上面的配置块添加到 claude_desktop_config.json。
• Cursor / 其他客户端： 将其添加到客户端的 mcp.json（格式相同）。

配置

环境变量	必填	默认值	用途
SEDIS_API_KEY	是	—	你的 PartnerAPI v2 密钥。仅作为 X-Api-Key 请求头发送；绝不记录日志。
SEDIS_API_BASE_URL	否	https://api.sedis.se	覆盖 v2 基础 URL（例如，用于 alpha/beta 环境）。
SEDIS_API_SESSION	否	—	可选的启动会话令牌 种子（仅限用户所有的密钥）。作为 X-Api-Session 发送；绝不记录日志。通常你可以在运行时使用 set_session 工具设置此项，无需重启。

密钥采用延迟验证——服务启动时无需密钥；如果缺失或无效，会在首次调用工具时返回友好且可执行的错误信息。 启动时不会发送 ping。

看不到工具？ MCP 服务会在你的客户端启动时加载—— 编辑配置后，请彻底重启／重新加载客户端（在同一窗口中开一个新聊天并不足够）。如果你通过 CLI（claude mcp add）注册了它，请确保它位于正确的作用域：在某个目录中添加的服务，在其他项目中不可见，除非使用全局／用户作用域。

会话令牌（用户所有的密钥）

如果你的密钥属于某位特定用户（签发给具名人员，而非机器／M2M 集成密钥），PartnerAPI v2 要求除了 X-Api-Key 之外还提供一个短期有效的会话令牌，并通过双重身份验证定期刷新：

1. 当收到原因是 session_expired／session_invalid 的 401 时，工具错误中会包含 reproveUrl。在浏览器中打开该链接，完成双重身份验证，并复制新生成的 sedis_sess_… 令牌。
2. 使用 set_session 工具粘贴令牌——它会在下一次调用时立即作为 X-Api-Session 发送，无需重启客户端。使用 clear_session 退出登录。
3. 也可以在启动时通过 SEDIS_API_SESSION 环境变量预置令牌（便于 CI／高级用户使用）；运行时设置的 set_session 始终优先。

机器／组织级密钥（无所有者）可无交互使用——仅需 X-Api-Key，无需会话令牌，也不需要调用 set_session。

本地开发／针对非生产环境进行测试

要运行本地构建（未发布）或指向非生产环境，请将 npx 替换为构建后的入口点，并覆盖基础 URL：

{
  "mcpServers": {
    "sedis-local": {
      "command": "node",
      "args": ["/absolute/path/to/sedis-mcp/build/index.js"],
      "env": {
        "SEDIS_API_KEY": "your-non-production-key",
        "SEDIS_API_BASE_URL": "https://<your-non-production-host>"
      }
    }
  }
}

请向 Sedis 团队询问主机名——非生产环境未公开记录。此设置仅为开发便利；生产环境用户只需使用上方的 npx -y @sedis/mcp 配置块，并提供单个 SEDIS_API_KEY，其默认值为 https://api.sedis.se。

工具

所有工具均为只读。v2 会强制执行租户范围：名称中带有“YOUR …”的工具只会返回你的密钥有权访问的数据；请求其他租户的对象时会返回友好的 未找到 错误（绝不会返回会泄露对象是否存在的 403 错误）。

Bolagsanalys（上市公司财务数据）

工具	功能
bolagsanalys_list_companies	按名称片段搜索上市公司目录。
bolagsanalys_find_parameter	按名称片段查找合适的财务参数。
bolagsanalys_get_data	获取季度数据。传入一个 companyId；也可以省略它，以获取某个参数／季度的所有公司数据。
bolagsanalys_search_data	批量获取指定公司集合的数据——companyIds[]（最多 50 个）。

房地产基准（房地产可比对象）

工具	功能说明
fastighetsbenchmark_find_parameter	按名称查找合适的房地产基准参数。
fastighetsbenchmark_search_property_units	按精确的 name、名称片段、市镇、区域或物业类型名称（propertyTypeName，例如“Office”/“Kontor”）查找您的物业单元（Fastighet）。
fastighetsbenchmark_list_samlingar	列出您的集合（Samling）及其成员。
fastighetsbenchmark_list_jamforelseobjekt	列出您的比较区域（Jämförelseobjekt）。
fastighetsbenchmark_get_comp_timeseries	获取实际的 CompDatum 基准时间序列（值带有自我描述信息）。
fastighetsbenchmark_list_reference_zones	列出共享的、由 Sedis 所有的市场参考区域（对每个密钥都相同）。
fastighetsbenchmark_list_municipalities	查询 municipalityId 筛选器所需的市镇 ID — 可按名称或官方代码查询（例如 SCB 0180）。
fastighetsbenchmark_list_property_types	查询 propertyType 筛选器所需的物业类型 ID（EB0 域）。

名称和描述默认使用英语；在参数发现和物业单元工具中传入 lang: "sv" 即可获取瑞典语。

会话（用户拥有的密钥）

工具	功能说明
set_session	粘贴新生成的 sedis_sess_… 令牌（来自重新验证页面）— 后续调用会携带为 X-Api-Session，无需重启。
clear_session	清除当前会话令牌（退出登录）。

这些工具仅适用于用户拥有的密钥（参见上文的 会话令牌（用户拥有的密钥））； 机器级 / 组织级密钥不使用这些工具。

错误会将 PartnerAPI v2 的 RFC 7807 问题响应转换为简短、易懂的工具错误，并附带供支持人员使用的 traceId — 且绝不会包含 API 密钥或堆栈跟踪。如果工具报告会话 / 双重验证重新验证错误，请打开消息中的 reproveUrl，完成 2FA，复制新的 sedis_sess_… 令牌，并通过 set_session 工具粘贴 — 然后重试（无需重启客户端）。参见上文的 会话令牌（用户拥有的密钥）。

API 参考

此服务是一个封装层。底层端点、查询约定、多租户隔离模型、几何数据、错误格式、速率限制和数据新鲜度均记录在 Sedis 随 API 密钥提供的 PartnerAPI v2 指南中 — 如需访问权限，请联系 Sedis。实时 OpenAPI 描述可通过 <SEDIS_API_BASE_URL>/openapi/v2.json 获取（默认地址为 https://api.sedis.se/openapi/v2.json）。 本 README 不会重复该参考文档的内容。

数据使用

在 AI/LLM 场景中使用 Sedis 数据须遵守您与 Sedis 的协议及随附的 MCP 数据使用条款。有关密钥处理和供应链安全状况，请参见 SECURITY.md。

许可证

MIT。