Borsdata MCP Server

Borsdata MCP服务器

MCP（模型上下文协议）服务器，公开 波兹达 财务数据API作为克劳德的工具和资源。涵盖北欧和全球股票、财务报告、关键绩效指标、股价、持股和日历。

快速开始

先决条件

• Node.js 18+
• Borsdata API密钥（需要专业会员资格-通过申请 Borsdata MyPage)

添加到克劳德代码

从项目目录运行以下命令：

claude mcp add borsdata -- npx borsdata-mcp-server

然后将API键设置为环境变量。您可以：

1. 添加到您的shell配置文件 (.bashrc, .zshrc等等）：

   export BORSDATA_API_KEY=your-api-key-here

1. 或者在中配置它 .mcp.json （项目级）手动：

   {
     "mcpServers": {
       "borsdata": {
         "command": "npx",
         "args": ["borsdata-mcp-server"],
         "env": {
           "BORSDATA_API_KEY": "your-api-key-here"
         }
       }
     }
   }

添加到克劳德桌面

添加到您的Claude桌面配置(claude_desktop_config.json):

{
  "mcpServers": {
    "borsdata": {
      "command": "npx",
      "args": ["borsdata-mcp-server"],
      "env": {
        "BORSDATA_API_KEY": "your-api-key-here"
      }
    }
  }
}

替代方案：全局安装

npm install -g borsdata-mcp-server

然后使用 "command": "borsdata-mcp-server" 而不是 npx borsdata-mcp-server 在您的配置中。

替代方案：从源代码安装

git clone https://github.com/carlwestman/borsdata-mcp-server.git
cd borsdata-mcp-server
npm install
npm run build

然后将配置指向构建的输出（使用克隆它的完整路径）：

{
  "mcpServers": {
    "borsdata": {
      "command": "node",
      "args": ["
/dist/index.js"],
      "env": {
        "BORSDATA_API_KEY": "your-api-key-here"
      }
    }
  }
}

例如，如果您克隆到 ~/projects/borsdata-mcp-server，参数为 ["~/projects/borsdata-mcp-server/dist/index.js"].

______________________________________________________________________

与Claude一起使用--Claude.md代码段

为了获得最佳效果，请将Borsdata上下文添加到项目的 CLAUDE.md 所以克劳德知道如何有效地使用这些工具。复制以下内容 CLAUDE_MD_SNIPPET.md 进入你的项目 CLAUDE.md:

cat node_modules/borsdata-mcp-server/CLAUDE_MD_SNIPPET.md >> CLAUDE.md

或者从 直接。这为Claude提供了高效使用服务器所需的工作流程、工具参考、参数指南和常见KPI ID。

______________________________________________________________________

工具（共22个）

仪器

股价

财务报告

KPI筛选器（最新值）

KPI历史记录

控股公司（仅限Pro+）

日历

参考数据

其他

______________________________________________________________________

MCP资源（知识库）

服务器公开3个MCP资源，代理可以读取这些资源以了解API的不透明ID和参数。这些是使工具可用的关键——没有它们，代理就不会知道“市盈率”映射到 kpiId=2.

1. borsdata://guide/api-overview -API指南

代理人首先阅读的全面参考文件。包含：

• 典型工作流程：按名称搜索仪器→ 投保→ 将insId与其他工具一起使用
• 数据层：北欧专业版和全球专业版有什么可供选择+
• 费率限制：100个电话/10秒，建议每天最多10000个
• 仪器类型：完整的ID到名称映射（0=股票，1=优先股，2=北欧指数等）
• 报告类型: year 对比 r12 （滚动12个月）vs quarter，最大计数，货币标志
• KPI参数:

- calcGroup: 1year, 3year, 5year, 7year, 10year, 15year, last - calc: high, low, mean, cagr, latest - reportType: year, r12, quarter - priceType: low, mean, high

• 常见KPI ID：市盈率=2，市盈率=3，市盈率=4，股息收益率=1，每股收益=6，净资产收益率=34，净资产回报率=35
• 报告期：1=Q1，2=Q2，3=Q3，4=Q4，5=全年

2. borsdata://reference/kpi-metadata --KPI查询表

动态资源 -第一次访问时从Borsdata API获取，然后缓存。返回所有可用KPI ID的标记表：

| kpiId | English Name | Swedish Name | Format | IsString |
|-------|-------------|-------------|--------|----------|
| 1     | Dividend Yield | Direktavkastning | percentage | false |
| 2     | P/E          | P/E          | number | false    |
| 3     | P/S          | P/S          | number | false    |
| 4     | P/B          | P/B          | number | false    |
| 5     | Revenue Per Share | Omsättning/aktie | number | false |
| 6     | Earnings Per Share | Vinst/aktie | number | false |
| ...   | ...          | ...          | ...    | ...      |

这是唯一最重要的资源。它允许代理将人类可读的KPI名称（如“股本回报率”）转换为数字 kpiId 所需 get_kpi, get_kpi_all，以及 get_kpi_history.

3. borsdata://reference/report-fields --报表字段元数据

动态资源 -第一次访问时从Borsdata API获取，然后缓存。返回一个markdown表，解释财务报告中每个字段的含义：

| Field Name              | English Name              | Swedish Name           | Format  |
|------------------------|--------------------------|----------------------|---------|
| revenues               | Revenues                 | Omsättning           | number  |
| gross_Income           | Gross Income             | Bruttoresultat       | number  |
| operating_Income       | Operating Income         | Rörelseresultat      | number  |
| profit_Before_Tax      | Profit Before Tax        | Resultat före skatt  | number  |
| earnings_Per_Share     | Earnings Per Share       | Vinst per aktie      | number  |
| total_Assets           | Total Assets             | Totala tillgångar    | number  |
| free_Cash_Flow         | Free Cash Flow           | Fritt kassaflöde     | number  |
| ...                    | ...                      | ...                  | ...     |

代理使用它来理解由返回的40多个字段 get_reports, get_all_reports，以及 get_reports_batch.

______________________________________________________________________

API 参考

此服务器包装 Borsdata API v1.附加文件：

• Swagger用户界面
• API Wiki
• OpenAPI JSON

速率限制

• 每10秒100个呼叫 （由服务器内置的速率限制器强制执行）
• 建议每天最多拨打10000个电话
• UTC时间20:00后每天更新数据（仅限当天结束，不包括当天）

数据层

______________________________________________________________________

发展（来源）

git clone https://github.com/carlwestman/borsdata-mcp-server.git
cd borsdata-mcp-server
npm install
npm run dev           # Run with tsx (auto-compiles TypeScript)
npm run build         # Compile to dist/
npm start             # Run compiled output
npm test              # Run tests (vitest)
npm run lint          # Lint with eslint

项目结构

src/
  index.ts              # Entry point — McpServer + StdioServerTransport
  api/
    client.ts           # BorsdataClient HTTP wrapper
    rate-limiter.ts     # Sliding window rate limiter
    types.ts            # TypeScript interfaces for API responses
  tools/                # Tool registration (one file per domain)
  resources/            # MCP Resources (knowledge base)
  utils/
    errors.ts           # Structured error handling

许可证

ISC