MCP NLX Node.js Server

MCP NLX Node.js サーバー

プロジェクトの説明

このプロジェクトは、NLX フレームワークを使用した Model Context Protocol（MCP）の Node.js サーバー実装です。ツールリクエストを処理し、API 呼び出しを介して NLX アプリケーションと通信できるサーバーを提供します。

設定

Claude Desktop

1. Claude Desktop の設定を開きます。

   open ~/Library/Application\ Support/Claude/claude_desktop_config.json
   

2. NLX アプリケーションの設定を追加します。

   {
     "mcpServers": {
       "nlx": {
         "command": "npx",
         "args": ["-y", "@nlxai/mcp-nodejs-server"],
         "env": {
           "NLX_API_KEY": "",
           "NLX_APP_URL": ""
         }
       }
     }
   }
   

セットアップ

前提条件

• Node.js（バージョン 18 以降）
• npm（Node Package Manager）

インストール

1. リポジトリをクローンします。

   git clone <repository-url>
   

2. プロジェクトディレクトリに移動します。

   cd nlx-mcp-server
   

3. 依存関係をインストールします。

   npm install
   

使用方法

環境変数

• NLX_APP_URL：NLX アプリケーションのベース URL です。
• NLX_API_KEY：NLX アプリケーションへのリクエストを認証するための API キーです。

サーバーの実行

サーバーを起動するには、次のコマンドを実行します。

npm run start

サーバーが起動し、標準入出力を介してリクエストを待ち受けます。

トラブルシューティング

よくある問題

• モジュールが見つからないエラー：すべての依存関係が正しくインストールされていること、およびインポート文のパスが正しいことを確認してください。
• 環境変数：環境内で NLX_APP_URL と NLX_API_KEY が正しく設定されていることを確認してください。

リンターエラー

• モジュールが見つからない：モジュールのパスが正しく、モジュールがインストールされていることを確認してください。
• 暗黙の 'any' 型：暗黙の 'any' 型を避けるために、TypeScript の型定義を追加することを検討してください。

リリース管理

Semantic Release によるリリースの自動化

このプロジェクトでは、バージョン管理とリリースのプロセスを自動化するために semantic-release を使用しています。Semantic Release により、コミットメッセージに基づいてバージョン番号と変更履歴が自動的に更新されます。

コミットメッセージの形式

Semantic Release では、Angular のコミットメッセージ規約を使用します。形式の概要は次のとおりです。

• feat：新機能
• fix：バグ修正
• docs：ドキュメントのみの変更
• style：コードの意味に影響しない変更（空白、書式、セミコロンの不足など）
• refactor：バグ修正や機能追加を伴わないコード変更
• perf：パフォーマンスを向上させるコード変更
• test：不足しているテストの追加、または既存テストの修正
• chore：ビルドプロセス、またはドキュメント生成などの補助的なツールやライブラリの変更

リリース方法

新しいリリースを作成するには、変更を main ブランチにプッシュするだけです。CI/CD パイプラインが自動的に semantic-release を実行し、次のバージョン番号を決定して、変更履歴を更新し、リリースを公開します。

正しいバージョン更新を行うには、コミットメッセージが Angular の規約に従っていることを確認してください。

CI/CD に問題が発生した場合は、次のコマンドを実行して手動でリリースを開始できます。

npx semantic-release --no-ci