alternativespe-mcp

Name: alternativespe-mcp
Author: luarss

本地服务

github.com/luarss金融数据06 周前更新

代码仓库

关于 alternativespe-mcp

alternativespe-mcp 是一个 MCP 服务，通过 Alternatives Partner API v3 提供东南亚私募市场数据的只读访问。它支持筛选搜索，并可查询公司、投资者、基金、个人及服务提供商详情。

主要功能

01搜索公司、投资者、基金和个人
02按 UUID 获取实体详情
03使用嵌套筛选条件和搜索选项
04通过参考数据发现字段取值
05自动交换并刷新 API 令牌

适用场景

01按国家或估值查找获投公司
02查看投资者组合和基金详情
03查找创始人、高管及服务提供商

MCP 相关

将 Alternatives Partner API v3 的搜索、详情和参考数据操作作为工具提供给 MCP 客户端，并自动处理 API 密钥交换和令牌刷新。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "luarss-alternativespe": {
      "command": "npx",
      "args": [
        "-y",
        "alternativespe-mcp"
      ],
      "env": {
        "ALTDMP_API_KEY": "<ALTDMP_API_KEY>",
        "ALTDMP_BASE_URL": "<ALTDMP_BASE_URL>"
      }
    }
  }
}

启动命令npx -y alternativespe-mcp

需要配置的环境变量

ALTDMP_API_KEY密钥Your Alternatives Partner API key (obtain from [email protected])

ALTDMP_BASE_URLOverride the API base URL (default: https://api.altdmp.io/v3)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmalternativespe-mcp0.1.1stdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
limit	integer	否	页面大小（默认 API 值）。
offset	integer	否	分页偏移量。
search	string	否	全文搜索词（查询字符串）。
filters	object	否	转发到 API "filters" 请求体的筛选树。使用逻辑组（"all" = AND，"any" = OR，"not" = 取反），其中包含格式为 {"op": <operator>, "field": <field>, "value": <value>} 的条件。运算符：eq、in、gt、gte、lt、lte、range（双元素数组）、contains、isnull。示例：{"all": [{"op": "eq", "field": "trading_status_key", "value": "operating"}, {"op": "gte", "field": "total_funding_usd", "value": 1e8}]}
ordering	string	否	排序字段；添加前缀 "-" 表示降序。

详细介绍

alternativespe-mcp

适用于 Alternatives Partner API v3（altdmp.io）的 MCP 服务，可只读地通过程序访问东南亚的私募市场数据（已获融资的公司、投资者、基金、人员、服务提供商）。

功能

自动处理 API 密钥到 bearer 令牌的交换，并缓存 / 刷新令牌。
为每个列表端点提供完整的 POST 筛选树（all/any/not + 运算符），以及 search、ordering、limit、offset。
为每个核心实体提供通过 UUID 获取详情的工具。

工具

工具	端点	描述
`search_capital_receivers`	`POST /capital-receivers/`	已获融资的公司 / 初创公司
`get_capital_receiver`	`GET /capital-receivers/{uuid}/`	公司详情：财务数据、股权结构、投资者、交易、新闻
`search_capital_allocators`	`POST /capital-allocators/`	投资者（VC/PE、企业、家族办公室）
`get_capital_allocator`	`GET /capital-allocators/{uuid}/`	投资者详情：投资、AUM、承诺出资、基金、新闻
`search_funds`	`POST /funds/`	基金（Atlas 级别）
`get_fund`	`GET /funds/{uuid}/`	基金详情：业绩、AUM、承诺出资、投资
`search_people`	`POST /people/`	创始人、董事、高管
`get_person`	`GET /people/{uuid}/`	人员详情：职务、投资、新闻
`search_service_providers`	`POST /service-providers/`	审计、法律和专业服务
`search_investors`	`POST /investors/`	跨实体投资者发现
`get_reference_data`	`GET /reference-data/`	枚举、国家、行业、主题

设置

npm install
npm run build

设置 API 密钥（通过 [email protected] 获取凭据）：

export ALTDMP_API_KEY=your_api_key_here

在 Claude Desktop / Claude Code 中使用

添加到 MCP 配置中（例如 claude_desktop_config.json）：

{
  "mcpServers": {
    "alternativespe": {
      "command": "node",
      "args": ["/absolute/path/to/alternativespe-mcp/dist/index.js"],
      "env": {
        "ALTDMP_API_KEY": "your_api_key_here"
      }
    }
  }
}

或者，在不构建的情况下进行本地开发：

{
  "mcpServers": {
    "alternativespe": {
      "command": "npx",
      "args": ["tsx", "/absolute/path/to/alternativespe-mcp/src/index.ts"],
      "env": { "ALTDMP_API_KEY": "your_api_key_here" }
    }
  }
}

筛选

filters 会原样转发为 API 的 filters 请求体。使用条件组合逻辑组：

{
  "filters": {
    "all": [
      { "op": "eq", "field": "domicile_country_iso_alpha3", "value": "SGP" },
      { "op": "gte", "field": "latest_valuation_usd", "value": 50000000 },
      { "any": [
        { "op": "eq", "field": "is_raising_now", "value": true },
        { "op": "in", "field": "themes_keys", "value": ["themes_payments"] }
      ]}
    ]
  },
  "limit": 50,
  "ordering": "-latest_valuation_usd"
}

运算符： eq、in（数组）、gt、gte、lt、lte、range（2 元素数组）、contains、isnull。 逻辑组： all（AND）、any（OR）、not（取反）。

使用 get_reference_data 查找有效的字段枚举值。

说明

速率限制：每滚动 60 秒最多 320 个请求（由 API 强制执行）。
订阅级别：Atlas（所有端点）和 Allocate（不包括基金和投资者承诺出资）。
令牌有效期为 24 小时；此服务会自动刷新令牌。

环境变量

变量	必需	默认值	描述
`ALTDMP_API_KEY`	是	—	你的 Alternatives Partner API 密钥
`ALTDMP_BASE_URL`	否	`https://api.altdmp.io/v3`	覆盖 API 基础 URL

发布

npm 和 MCP Registry 均通过 OIDC 发布 — 此仓库不存储长期令牌。

npm（可信发布 / OIDC）

自动发布使用 npm Trusted Publishing：GitHub Actions 通过短时效 OIDC 向 npm 进行身份验证，并自动生成来源证明 — 无需 NPM_TOKEN。

在 npmjs.com 上进行一次性设置（首个版本发布后 — 见下文的初始化步骤）：选择软件包 Settings → Trusted Publisher → GitHub Actions，并设置：

字段	值
组织 / 用户	`luarss`
仓库	`alternativespe-mcp`
工作流文件名	`publish-mcp-registry.yml`
环境	`release`

初始化： 只有在软件包已存在后才能配置可信发布者，因此必须先手动发布首个版本 — 在本地运行 npm publish --access public — 然后为后续所有版本配置可信发布者。

MCP 注册表

通过 mcp-publisher CLI 使用 GitHub OIDC（mcp-publisher login github-oidc）将 server.json 发布到官方 MCP 注册表——同样无需令牌。

自动发布

推送 v* 标签（例如 git tag v0.1.0 && git push origin v0.1.0）会触发 .github/workflows/publish-mcp-registry.yml。该任务在受保护的 release GitHub 环境中运行（需要审核者批准，且仅允许 v* 标签），因此发布需要等待人工批准，随后通过 OIDC 发布到 npm，并将 server.json 的版本同步为该标签，然后通过 OIDC 将其发布到注册表。