Mcptix

🚀 mcptix

mcptixは、プロジェクトでの初期化と実行が容易なツールです。MCPプロトコルの統合や高度な設定が可能で、開発の効率化に役立ちます。

🚀 クイックスタート

プロジェクトでmcptixを初期化して実行するには、以下のコマンドを使用します。

# プロジェクトでmcptixを初期化
npx mcptix init

# mcptixを実行し、自動的にブラウザを開く
npx mcptix start

# 設定パラメータの例:
npx mcptix start --port 3001 --host 0.0.0.0 --no-open

✨ 主な機能

MCP プロトコルの統合

MCP サーバーの設定手順:

1. プロジェクトを初期化し、依存関係をインストールします。

npm install @ownlytics/mcptix

2. MCP 設定ファイルを作成または変更します。

// .mcptix/mcptix.mcp.json
{
  "mcpEnabled": true,
  "mcpPort": 5001,
  "nodePath": "/usr/bin/node",
  "mcpServerPath": "./node_modules/.bin/mcptix-mcp"
}

3. MCP サーバーを起動するスクリプトを package.json に追加します。

{
  "scripts": {
    "start:mcp": "mcptix mcp --port ${NODE_PORT}"
  }
}

4. AI アシスタントで MCP サービスを起動します。

// サンプル Node.js コード
const exec = require('child_process').exec;
exec('npm run start:mcp', (error, stdout) => {
    if (error) {
        console.error('MCP の起動に失敗しました:', error);
        return;
    }
    console.log('MCP が起動しました');
});

高度な設定

.mcptix/mcptix.config.js ファイルを変更して、mcptix をカスタマイズできます。

module.exports = {
  // データベース設定
  dbPath: './.mcptix/data/mcptix.db',

  // API サーバー設定
  apiPort: 3000,
  apiHost: 'localhost',

  // サーバーオプション
  mcpEnabled: false, // デフォルトでは無効 - MCP サービスは LLM アシスタントによって起動されます
  apiEnabled: true,

  // ログ設定
  logLevel: 'info',

  // データ管理
  clearDataOnInit: false,
};

一般的なカスタマイズ

• ポートの変更：3000 ポートが使用中の場合は、apiPort を別の数字に変更します。
• データ保存場所の変更：データディレクトリを変更する場合は、dbPath を調整します。

🔧 トラブルシューティング

インストール問題

• "コマンドが見つかりません" と表示される場合

  • mcptix がインストールされていることを確認します (npm install @ownlytics/mcptix)。
  • 完全なパスを使用してみます：./node_modules/.bin/mcptix。

• 初期化に失敗した場合

  • 現在のディレクトリに書き込み権限があることを確認します。
  • Node.js がインストールされており、バージョンが正しいことを確認します。

mcptix UI の起動に失敗した場合

• ポートが使用中の場合

  • .mcptix/mcptix.config.js のポートを変更します。
  • 他のインスタンスが実行中でないことを確認します。

• データベースエラーが発生した場合

  • dbPath が正しく、アクセス可能であることを確認します。
  • ログファイルを確認して、詳細な情報を取得します。

AI 統合問題

• MCP の起動に失敗した場合
  • Node.js のパスが正しく設定されていることを確認します。
  • すべての依存関係が正しくインストールされていることを確認します。

💻 コマンドラインリファレンス

# プロジェクトを初期化
npx mcptix init

# 実行してブラウザを開く
npx mcptix start

# API サービスのみを起動
npx mcptix start --only-api

# MCP サービスを起動
npx mcptix mcp --port 5001

📄 ライセンス

mcptix は MIT License に準拠しています。詳細については、プロジェクトリポジトリを参照してください。

mcptix をご利用いただき、ありがとうございます！さらなる支援が必要な場合は、ドキュメントを参照するか、サポートチームにお問い合わせください。