文档生成服务

Rynko MCP服务器是一个通过自然对话管理模板并生成文档的服务,适用于Claude桌面应用。

  • by renderbase
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 renderbase/mcp-server

使用说明

@rynko/mcp服务器

用于Claude Desktop的Rynko MCP服务器-通过自然对话管理模板和生成文档。

安装

选项1:一键安装(推荐)

即将推出:直接从Claude Desktop Extensions目录安装。

或从安装 .mcpb 捆绑:

  1. 下载 rynko-mcp-{version}.mcpb 从 发布页面
  2. 在Claude Desktop中,转到 设置 → 扩展
  3. 点击 从文件安装 并选择已下载的 .mcpb 文件
  4. 出现提示时输入您的个人访问令牌
  5. 完成!开始和克劳德谈论你的文件。

选项2:NPX(手动设置)

全局安装:

npm install -g @rynko/mcp-server

或者直接与npx一起使用(推荐):

npx @rynko/mcp-server

手动设置

1.获取个人访问令牌(PAT)

  1. 登录到您的 Rynko仪表板
  2. 首选 设置 → 个人访问令牌
  3. 点击 创建令牌
  4. 输入标签(例如“Claude Desktop”)
  5. 选择到期日(最长30天)
  6. 复制令牌-它不会再显示!

2.配置克劳德桌面

添加到您的Claude Desktop配置文件中:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "rynko": {
      "command": "npx",
      "args": ["-y", "@rynko/mcp-server"],
      "env": {
        "RYNKO_USER_TOKEN": "pat_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

3.重新启动克劳德桌面

关闭并重新打开Claude Desktop。您应该在可用的MCP服务器中看到“rynko”。

可用工具

工作区工具

工具 说明
list_workspaces 列出您有权访问的所有工作区
get_workspace 获取特定工作空间的详细信息

模板工具

工具 说明
list_templates 列出工作区中的模板
get_template 获取模板详细信息和架构
create_draft_template 创建新的草稿模板
update_draft_template 更新草稿模板
validate_schema 验证模板架构
get_schema_reference 获取模板架构文档

数据工具

工具 说明
parse_data_file 将Excel或CSV数据解析为JSON
map_variables 自动将数据列映射到模板变量

生成工具

工具 说明
preview_template 生成预览文档
generate_document 生成生产文档
get_job_status 检查文档生成状态

示例用法

配置后,您可以与Claude进行自然对话:

你: 使用公司徽标、客户详细信息和行项目表创建发票模板。

克劳德: 我会为你创造它。让我先检查一下你的工作区。..

[使用Rynko工具创建模板]

你: 为Acme Corp生成一张发票,其中包含3行项目,总计1500美元。

克劳德: 我现在就生成发票。..

[使用模板生成PDF]

环境变量

变量 必填 描述
RYNKO_USER_TOKEN 是 您的个人访问令牌(以开头 pat_)
RYNKO_API_URL 否 自定义API URL(默认值: https://api.rynko.dev/api)

安全

  • 令牌到期:PAT最多在30天后到期
  • 仅限草稿:通过MCP创建的模板在手动发布之前都是草稿
  • 审计日志:所有操作都记录在团队的活动提要中
  • 可撤销的:立即从您的仪表板中撤销令牌

故障排除

“无效令牌”错误

  • 验证您的令牌以开头 pat_
  • 检查令牌是否已过期
  • 从仪表板生成新令牌

“连接失败”错误

  • 检查您的互联网连接
  • 验证Rynko API是否可访问
  • 尝试重新生成PAT

Claude Desktop找不到服务器

  • 检查配置文件JSON语法
  • 确保 npx 在你的路径中
  • 完全重新启动克劳德桌面

文档

支持

从源头构建

构建MCPB捆绑包

要构建Claude Desktop扩展包,请执行以下操作:

cd integrations/mcp-server
npm install
npm run build:mcpb

这将创建:

  • dist-mcpb/rynko-mcp-{version}.mcpb -扩展包
  • dist-mcpb/rynko-mcp-{version}.mcpb.sha256 -校验和文件

捆绑内容

rynko-mcp-{version}.mcpb
├── manifest.json     # Extension metadata and configuration
├── server/           # Compiled server code
│   ├── index.js
│   └── client.js
└── icon.png          # Extension icon (optional)

目录提交

要提交到Claude Desktop Extensions目录,请执行以下操作:

  1. 构建MCPB捆绑包: npm run build:mcpb
  2. 通过“从文件安装”进行本地测试
  3. 通过提交 Anthropic扩展提交表
  4. 包括:
    • 扩展名和描述
    • 隐私政策网址
    • 服务条款URL
    • 3+使用示例
    • 安全注释(数据访问、网络访问)

许可证

麻省理工学院