Nextgen MCP

🚀 Acrolinx MCP 服務器

Acrolinx MCP 服務器是一個基於模型上下文協議（MCP）的服務器，它與 Acrolinx NextGen API 集成，可為 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"）

🔧 技術細節

開發模式運行

npm run dev

運行測試

# 測試建議端點
node test-suggestions.js

# 測試完整工作流
node test-suggestions-complete.js

構建項目

npm run build

架構說明

該服務器使用標準輸入輸出（stdio）傳輸實現了模型上下文協議，並提供了四個與 Acrolinx NextGen API 交互的主要工具。主要特性包括：

• 重試邏輯：採用指數退避算法，提高可靠性。
• 超時處理：可配置長時間運行操作的超時時間。
• 全面日誌記錄：支持調試模式，方便故障排除。
• 類型安全：完全使用 TypeScript 實現，並配備適當的類型保護。
• 優雅關機：在終止時進行適當的清理。

可通過在環境中設置 DEBUG=true 來啟用調試日誌：

DEBUG=true npm run start

📄 許可證

本項目採用 MIT 許可證。

🤝 貢獻指南

1. 分叉倉庫。
2. 創建功能分支。
3. 進行修改。
4. 運行 npm run build 確保所有代碼都能正確編譯。
5. 提交拉取請求。

💬 技術支持

若遇到問題或有疑問，請按以下方式處理：

• 在 GitHub 上創建問題。
• 查看 Acrolinx 文檔。
• 聯繫 Acrolinx 支持團隊。