内容
<p align="center">
<strong>您的 AI 助手现在可以搜索超过 250M+ 家公司，覆盖 50+ 个国家。免费。</strong>
</p>
<p align="center">
<a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/MCP-compatible-purple" alt="MCP"></a>
<a href="https://www.npmjs.com/package/scala-mcp-server"><img src="https://img.shields.io/npm/v/scala-mcp-server" alt="npm 版本"></a>
<a href="https://www.npmjs.com/package/scala-mcp-server"><img src="https://img.shields.io/npm/dm/scala-mcp-server" alt="npm 下载量"></a>
<a href="https://github.com/Alessandro114/scala-mcp-server/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Alessandro114/scala-mcp-server" alt="许可证"></a>
<a href="https://get-scala.com/score"><img src="https://img.shields.io/badge/companies-250M%2B-green" alt="公司数量"></a>
<a href="https://smithery.ai/server/Alessandro114/scala-mcp-server"><img src="https://smithery.ai/badge/Alessandro114/scala-mcp-server" alt="Smithery"></a>
<a href="https://glama.ai/mcp/servers/Alessandro114/scala-mcp-server"><img src="https://glama.ai/mcp/servers/Alessandro114/scala-mcp-server/badges/score.svg" alt="Glama 评分"></a>
</p>
# S.C.A.L.A. MCP 服务器
一个 [MCP 服务器](https://modelcontextprotocol.io)，为 Claude、ChatGPT、Codex 和任何 MCP 兼容的 AI 代理提供访问 [S.C.A.L.A. 评分](https://get-scala.com/score) 公司情报数据库的权限 —— 覆盖 250M+ 家公司，50+ 个国家。
## 快速开始
```bash
npx -y scala-mcp-server
```
就这样。一个命令。设置您的 API 密钥并开始：
```bash
SCALA_API_KEY=your-key npx -y scala-mcp-server
```
> 在 [app.get-scala.com](https://app.get-scala.com) 获取免费的 API 密钥 —— 无需信用卡。
---
## 功能
连接后，您的 AI 助手可以：
- **搜索公司** 按名称、增值税编号、关键词 —— 覆盖 50+ 个国家
- **查询** 详细的公司资料（收入、员工、健康评分、行业）
- **生成报告** （财务健康、风险评估、尽职调查）
- **探索数据库** —— 统计数据、国家覆盖、信用余额
## 设置
### Smithery（推荐）
通过 [Smithery](https://smithery.ai/server/Alessandro114/scala-mcp-server) 自动安装：
```bash
npx @smithery/cli mcp add Alessandro114/scala-mcp-server --config '{"scalaApiKey":"your-api-key"}'
```
### Claude 桌面版
添加到您的 `claude_desktop_config.json`：
<details>
<summary><strong>macOS</strong>: <code>~/Library/Application Support/Claude/claude_desktop_config.json</code></summary>
```json
{
"mcpServers": {
"scala-score": {
"command": "npx",
"args": ["-y", "scala-mcp-server"],
"env": {
"SCALA_API_KEY": "your-api-key"
}
}
}
}
```
</details>
<details>
<summary><strong>Windows</strong>: <code>%APPDATA%\Claude\claude_desktop_config.json</code></summary>
```json
{
"mcpServers": {
"scala-score": {
"command": "npx",
"args": ["-y", "scala-mcp-server"],
"env": {
"SCALA_API_KEY": "your-api-key"
}
}
}
}
```
</details>
### Claude 代码
```bash
claude mcp add scala-score -e SCALA_API_KEY=your-key -- npx -y scala-mcp-server
```
### 任意 MCP 客户端
```bash
SCALA_API_KEY=your-key npx -y scala-mcp-server
```
或全局安装：
```bash
npm install -g scala-mcp-server
SCALA_API_KEY=your-key scala-mcp
```
## 工具
| 工具 | 描述 | 积分 |
|------|-------------|---------|
| `search_companies` | 按名称、增值税、关键词搜索，附带国家/NACE/状态过滤器 | 1 |
| `lookup_company` | 按 ID 或增值税编号查询完整公司资料 | 1 |
| `company_report` | 健康报告 —— 基础（5）、专业（10）、企业（20） | 5-20 |
| `database_stats` | 总公司数量、国家、最后更新时间 | 0 |
| `list_countries` | 所有国家及其公司数量 | 0 |
| `check_credits` | 剩余积分、计划信息、重置日期 | 0 |
## 演示
这是一个真实对话的示例：
> **您：** 查找意大利排名前 10 的餐厅连锁店
> **Claude：** *使用 `search_companies`，查询="ristorante catena"，国家="IT"，nace="56.10"*
>
> 我找到了意大利的 10 家餐厅连锁店。以下是按收入排名最大的公司：
>
> | # | 公司 | 收入 | 员工 | 健康评分 |
> |---|---------|---------|-----------|--------|
> | 1 | AUTOGRILL S.P.A. | 32 億欧元 | 12,400 | 82/100 |
> | 2 | CHEF EXPRESS S.P.A. | 8.9 億欧元 | 4,200 | 78/100 |
> | ... | | | | |
---
> **您：** 查询 Ferrero 的财务健康状况
> **Claude：** *使用 `lookup_company`，公司 ID="IT02727330014"*
>
> **Ferrero International S.A.**
> - 收入：170 億欧元
> - 员工：41,000+
> - 健康评分：94/100
> - NACE：10.82（可可、巧克力和糖果）
> - 状态：自 1946 年以来活跃
---
> **您：** 比较米兰和慕尼黑的建筑公司
> **Claude：** *使用 `search_companies` 两次，国家="IT"/国家="DE"，nace="41"*
>
> 米兰的建筑公司数量是慕尼黑的 3 倍，但慕尼黑公司的平均收入高 40%。健康评分相当（平均 68 vs 71）。
## 获取您的 API 密钥
1. 在 [app.get-scala.com](https://app.get-scala.com) 注册
2. 导航到 **Score > API**
3. 生成您的密钥
4. 将 `SCALA_API_KEY` 设置为环境变量
免费套餐包含积分，帮助您入门 —— 无需信用卡。
## 定价
| 计划 | 每月积分 | 适合 |
|------|-----------|----------|
| 免费 | 50 | 测试、评估 |
| 入门 | 500 | 个人项目 |
| 增长 | 5,000 | 常规查询 |
| 企业 | 50,000+ | 大批量分析、集成 |
参见 [get-scala.com/score](https://get-scala.com/score) 获取当前定价。
## 工作原理
```
您的 AI 助手 <--> MCP 协议 <--> scala-mcp-server <--> S.C.A.L.A. 评分 API
|
250M+ 家公司
50+ 个国家
NACE 行业代码
财务数据
```
服务器使用 **[Model Context Protocol](https://modelcontextprotocol.io)** 通过 **stdio** 进行通信。无需 HTTP 服务器、无需端口、无需 API 密钥以外的配置。
## 贡献
欢迎贡献！以下是贡献方式：
1. 分叉仓库
2. 创建功能分支：`git checkout -b feature/my-feature`
3. 进行更改
4. 运行构建：`npm run build`
5. 在本地测试：`SCALA_API_KEY=test npx .`
6. 提交：`git commit -m "feat: add my feature"`
7. 推送：`git push origin feature/my-feature`
8. 打开拉取请求
### 开发
```bash
git clone https://github.com/Alessandro114/scala-mcp-server.git
cd scala-mcp-server
npm install
npm run dev # 使用 tsx 运行（热重载）
npm run build # 编译 TypeScript
```
## 生态系统
- **[enrich-companies (npm)](https://www.npmjs.com/package/enrich-companies)** -- 用于丰富 CSV 文件的 CLI 工具，附带公司数据
- **[enrich-companies (PyPI)](https://pypi.org/project/enrich-companies/)** -- 相同的工具，Python 版本
- **[Score Company Lookup](https://chromewebstore.google.com/detail/score-company-lookup/)** -- Chrome 扩展程序
- **[scala-score (PyPI)](https://pypi.org/project/scala-score/)** -- Python SDK
- **[world-company-database](https://github.com/Alessandro114/world-company-database)** -- 批量数据集（Kaggle + HuggingFace）
- [Score API 文档](https://app.get-scala.com/api/docs/ui) -- REST API 文档
- [n8n 集成](https://github.com/Alessandro114/n8n-nodes-scala) -- n8n 工作流节点
## 许可证
[MIT](LICENSE) -- 版权所有 (c) 2026 Alessandro Binda / S.C.A.L.A. AI OS
