Nextgen MCP

🚀 Acrolinx MCP 服务器

Acrolinx MCP 服务器集成了 Acrolinx NextGen API，为像 Claude 这样的 AI 助手提供高级文本分析和改进功能。

🚀 快速开始

Acrolinx MCP 服务器集成了 Acrolinx NextGen API，你可以借助它为 AI 助手（如 Claude）提供高级文本分析和改进能力。

✨ 主要特性

• 文本改写：自动优化文本，提升清晰度、调整语气并确保符合风格指南。
• 内容分析：从多个维度获取详细的文本质量评分。
• 写作建议：获得具体的文本改进建议。
• 风格指南支持：支持 AP、《芝加哥手册》、微软和 Proofpoint 等风格指南。
• 多语言方言：支持美式、英式、澳式和加拿大英语。
• 语气灵活性：涵盖学术、商务、随意、对话、正式、Z 世代、非正式和技术等多种语气。

📦 安装指南

前提条件

• Node.js 18.0.0 或更高版本
• Acrolinx API 密钥

安装步骤

1. 克隆仓库：

git clone https://github.com/acrolinx/nextgen-mcp.git
cd nextgen-mcp

2. 安装依赖：

npm install

3. 配置环境变量：

cp .env.example .env
# 编辑 .env 文件并添加你的 ACROLINX_API_KEY

4. 构建项目：

npm run build

📚 详细文档

配置参数

与 Claude Desktop 配合使用

将服务器添加到你的 Claude Desktop 配置中：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

选项 1：直接从 GitHub 运行（推荐）

{
  "mcpServers": {
    "acrolinx": {
      "command": "npx",
      "args": [
        "-y",
        "github:acrolinx/nextgen-mcp"
      ],
      "env": {
        "ACROLINX_API_KEY": "your_api_key_here"
      }
    }
  }
}

选项 2：从本地安装运行

{
  "mcpServers": {
    "acrolinx": {
      "command": "node",
      "args": ["/path/to/nextgen-mcp/dist/index.js"],
      "env": {
        "ACROLINX_API_KEY": "your_api_key_here"
      }
    }
  }
}

可用工具

acrolinx_rewrite

自动改写和优化文本内容。 参数：

• text（必需）：要改写的文本
• dialect：语言方言（默认："american_english"）
• tone：期望的语气（默认："formal"）
• style_guide：要遵循的风格指南（默认："microsoft"）

acrolinx_check

分析文本质量问题，不进行修改。 参数：

• text（必需）：要分析的文本
• dialect：语言方言（默认："american_english"）
• tone：要检查的目标语气（默认："formal"）
• style_guide：要检查的风格指南（默认："microsoft"）

acrolinx_suggestions

获取详细的文本编辑建议。 参数：

• text（必需）：要获取建议的文本
• dialect：语言方言（默认："american_english"）
• tone：建议的目标语气（默认："formal"）
• style_guide：建议的风格指南（默认："microsoft"）

acrolinx_workflow_status

检查异步工作流的状态。 参数：

• workflow_id（必需）：要检查的工作流 ID
• workflow_type（必需）：工作流类型（"rewrites"、"checks" 或 "suggestions"）

🔧 技术细节

服务器使用标准输入输出（stdio）传输实现了模型上下文协议，并提供了四个与 Acrolinx NextGen API 交互的主要工具。主要特性包括：

• 重试逻辑：采用指数退避算法，提高可靠性。
• 超时处理：可配置长时间运行操作的超时时间。
• 全面日志记录：支持调试模式，便于故障排查。
• 类型安全：完全使用 TypeScript 实现，并配备适当的类型保护。
• 优雅关机：在终止时进行适当的清理。

你可以通过在环境中设置 DEBUG=true 来启用调试日志：

DEBUG=true npm run start

📄 许可证

本项目采用 MIT 许可证。

🤝 贡献指南

1. 分叉仓库。
2. 创建功能分支。
3. 进行修改。
4. 运行 npm run build 确保所有代码编译正常。
5. 提交拉取请求。

🛠️ 支持与反馈

如果你遇到问题或有疑问，可以：

• 在 GitHub 上创建问题。
• 查看 Acrolinx 文档。
• 联系 Acrolinx 支持团队。