Nextgen MCP

🚀 Acrolinx MCP Server

Acrolinx NextGen APIと統合されたModel Context Protocol (MCP) サーバーで、ClaudeのようなAIアシスタントに高度なテキスト分析と改善機能を提供します。

🚀 クイックスタート

Acrolinx MCP Serverは、Acrolinx NextGen APIと統合して、ClaudeなどのAIアシスタントに高度なテキスト分析と改善機能を提供するサーバーです。以下の手順でセットアップして使用を開始できます。

✨ 主な機能

• テキストの書き換え：明瞭さ、トーン、スタイルガイドの遵守に関して自動的にテキストを改善します。
• コンテンツ分析：複数の次元にわたる詳細な品質スコアを取得します。
• 文章改善提案：テキストの改善に関する具体的な推奨事項を受け取ります。
• スタイルガイドのサポート：AP、シカゴ文体便覧、Microsoft、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", or "suggestions")

開発

開発モードで実行

npm run dev

テストの実行

# 提案エンドポイントのテスト
node test-suggestions.js

# 完全なワークフローのテスト
node test-suggestions-complete.js

ビルド

npm run build

🔧 技術詳細

このサーバーは、stdioトランスポートを使用してModel Context Protocolを実装し、Acrolinx NextGen APIとやり取りする4つの主要なツールを提供します。主な機能は以下の通りです。

• リトライロジック：信頼性向上のための指数関数的バックオフ
• タイムアウト処理：長時間実行される操作のための設定可能なタイムアウト
• 包括的なロギング：トラブルシューティングのためのデバッグモード
• 型安全性：適切な型ガードを備えた完全なTypeScript実装
• グレースフルシャットダウン：終了時の適切なクリーンアップ

デバッグログを有効にするには、環境変数でDEBUG=trueを設定します：

DEBUG=true npm run start

📄 ライセンス

MIT

コントリビューション

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. npm run buildを実行して、すべてがコンパイルされることを確認します。
5. プルリクエストを送信します。

サポート

問題や質問については、以下の方法で対応します。

• GitHubでイシューを作成します。
• Acrolinxのドキュメントを確認します。
• Acrolinxサポートに問い合わせます。