# @fonoster/mcp 中文文档

规范地址：https://npmcn.com/package/%40fonoster/mcp/

版本：0\.61\.0
npm 元数据更新时间：2026-11-15T14:01:51.032Z
中文译文更新时间：2026-11-15T04:24:18.985Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40fonoster/mcp
原文对照：https://npmcn.com/package/%40fonoster/mcp/?lang=original
项目主页：https://github.com/fonoster/fonoster#readme
源码仓库：https://github.com/fonoster/fonoster

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：51 kB，25 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：5 个
- 首次发布：2025-03-06T06:01:53.643Z
- 最新版本发布：2026-11-15T14:01:50.659Z
- 近 30 天下载量：6592（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：122（近 12 个月 63 个）

## 中文简介

长老会示范背景议定书

## 安装

```sh
npm install @fonoster/mcp
```

也可以使用：`pnpm add @fonoster/mcp`、`yarn add @fonoster/mcp`、`bun add @fonoster/mcp`

## README

# 长老会 MCP 服务器

[![Discord](https://img.shields.io/discord/1016419835455996076?color=5865F2&label=Discord&logo=discord&logoColor=white)](https://discord.gg/4QWgSz4hTC) ![GitHub](https://img.shields.io/github/license/fonoster/fonoster?color=%2347b96d) ![Twitter Follow](https://img.shields.io/twitter/follow/fonoster?style=social)

MCP 磁共振 长老会API的服务器,使MCP客户端能够与长老会的电话服务互动. 这个模块是 [长老会](https://fonoster.com/) 开源项目. 有关该项目的更多信息,请访问 [https://github.com/fononster/fononster (英语)](https://github.com/fonoster/fonoster)。 。 。 .

## 工具

1.  `list_numbers`
    
    -   以表格格式(使用下标)返回长老会的数字清单
    -   可选输入 :
        -   `page_size` (数字):返回的最大数字
        -   `page_token` (字符串):下页的平面符
    -   回返:载有参考文件、姓名和电话号码的清单
2.  `list_applications`
    
    -   以表格格式列出长老会的申请(使用下标)
    -   可选输入 :
        -   `page_size` (数目):返回的最大应用程序数
        -   `page_token` (字符串):下页的平面符
    -   返回:载有参考文献、名称、终点、创建日期、更新日期和类型的应用程序清单
3.  `create_call`
    
    -   创建长老会的电话
    -   所需输入 :
        -   `from` (字符串):从
        -   `to` (字符串):要呼叫的号码
        -   `app_ref` (字符串):用于呼叫的应用程序的引用
        -   `metadata` (对象):要发送给应用程序的元数据
    -   返回: 使用参考ID进行呼叫创建确认
4.  `create_call_batch`
    
    -   创建一批来自长老会的电话
    -   所需输入 :
        -   `from` (字符串):从
        -   `to_array` (阵列):要呼叫的数字
        -   `app_ref` (字符串):用于呼叫的应用程序的引用
        -   `metadata` (对象):要发送给应用程序的元数据
    -   返回: 批次创建确认和引用 ID

## 提示

1.  `create_call_prompt`
    -   一步步创建呼叫的提示
    -   通过下列过程引导 MCP 客户端:
        -   如果尚未提供, 请用户拨打号码
        -   使用 `list_numbers` 工具
        -   询问申请名称并查找其参考文献
        -   使用 `create_call` 或者说 `create_call_batch` 工具,视用户请求而定

## 设置

### 使用 Claude 桌面

在您的 `claude_desktop_config.json`数字 :

> 如果您登录到命令行工具, 请运行 `fonoster mcp:configure --client claude` 以配置服务器.

#### npx 数据

```json
{
  "mcpServers": {
    "fonoster": {
      "command": "npx",
      "args": [
        "-y",
        "@fonoster/mcp"
      ],
      "env": {
        "MCP_WORKSPACE_ACCESS_KEY_ID": "your-workspace-access-key-id",
        "MCP_APIKEY_ACCESS_KEY_ID": "your-apikey-access-key-id",
        "MCP_APIKEY_ACCESS_KEY_SECRET": "your-apikey-access-key-secret"
      }
    }
  }
}
```

#### 插头

```json
{
  "mcpServers": {
    "fonoster": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_WORKSPACE_ACCESS_KEY_ID",
        "-e",
        "MCP_APIKEY_ACCESS_KEY_ID",
        "-e",
        "MCP_APIKEY_ACCESS_KEY_SECRET",
        "fonoster/mcp"
      ],
      "env": {
        "MCP_WORKSPACE_ACCESS_KEY_ID": "your-workspace-access-key-id",
        "MCP_APIKEY_ACCESS_KEY_ID": "your-apikey-access-key-id",
        "MCP_APIKEY_ACCESS_KEY_SECRET": "your-apikey-access-key-secret"
      }
    }
  }
}
```

### 环境变量

| 变量 | 说明 | 需求 |
| --- | --- | --- |
| `MCP_WORKSPACE_ACCESS_KEY_ID` | 您的工作空间访问密钥 ID | 对 |
| `MCP_APIKEY_ACCESS_KEY_ID` | 您的 API 密钥访问密钥 ID | 对 |
| `MCP_APIKEY_ACCESS_KEY_SECRET` | 您的 API 密钥 | 对 |
| `MCP_ENDPOINT` | 自定义 API 端点( 例如 ), `localhost:50051`(中文(简体) ) | 没有 |
| `FONOSTER_CA_FILE` | 证书管理机关的PEM 文件可信任, 如安装 `config/tls/ca.pem` | 没有 |

### 与MCP检查员的测试

```bash
MCP_WORKSPACE_ACCESS_KEY_ID="your-workspace-access-key-id" \
MCP_APIKEY_ACCESS_KEY_ID="your-apikey-access-key-id" \
MCP_APIKEY_ACCESS_KEY_SECRET="your-apikey-access-key-secret" \
npx @modelcontextprotocol/inspector \
node /path/to/fonoster/mods/mcp/dist/index.js
```

### 解决问题

如果遇到认证错误,请核实:

1.  你的长老证书正确
2.  环境变量设置得当
3.  您拥有进入长老会API的必要权限

## 构建

嵌入器构建 :

```bash
docker build -t fonoster/mcp -f Dockerfile .
```

## 常见问题

### @fonoster/mcp 是什么？

长老会示范背景议定书

### 如何安装 @fonoster/mcp？

在项目目录运行 npm install @fonoster/mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 fonoster-mcp，可以用 npx fonoster-mcp 直接运行。

### @fonoster/mcp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @fonoster/mcp 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @fonoster/mcp 可以商用吗？

@fonoster/mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @fonoster/mcp 的下载量有多少？

根据 npm 官方下载统计，@fonoster/mcp 在 2026/10/15 – 2026/11/13 这 30 天内被下载 6,592 次，日均约 220 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @fonoster/mcp 还在维护吗？

最新版本 0\.61\.0 发布于 2026/11/15（今天）；至今共发布 122 个版本，其中过去 12 个月发布了 63 个；首次发布于 2025/03/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。