MCP Terminal Server

🚀 MCP ターミナルサーバー

このサーバーは、モデルコンテキストプロトコル（MCP）用の安全なコマンドラインインターフェースです。AIモデルがターミナルと安全かつ制御可能にやり取りできるようにします。

✨ 主な機能

• 🔒 設定可能な権限を持つ安全なコマンド実行
• 📁 指定されたパス内でのファイルシステム操作
• 🌍 環境変数の管理
• 💻 クロスプラットフォーム対応（Windows、macOS、Linux）
• 🔌 コマンド実行を通じたリモートシステムへの接続

💻 使用例

基本的な使用法

Claude Desktopと一緒に使用する場合は、以下のようにサーバー設定をClaude Desktopの設定ファイルに追加します。

{
  "mcpServers": {
    "terminal": {
      "command": "npx",
      "args": [
        "@dillip285/mcp-terminal",
        "--allowed-paths",
        "/path/to/allowed/directory"
      ]
    }
  }
}

変更を適用するためにClaude Desktopを再起動します。これでClaudeを通じてターミナル機能を使用でき、安全なファイルアクセスとコマンド実行を楽しめます。

利用可能なツール

• execute_command：安全にターミナルコマンド（SSHやリモートコマンドを含む）を実行できます。

🔧 技術詳細

セキュリティ

• すべての操作は指定された許可パス内に制限されています。
• コマンドは検証とクリーニングを行ってから実行されます。
• 環境変数は厳密に管理されています。
• セキュリティ関連のエラーは適切にハンドリングされます。

開発

# リポジトリをクローンする
git clone https://github.com/dillip285/mcp-terminal.git

# 依存関係をインストールする
npm install

# npmの認証を設定する
cp .npmrc.example .npmrc
# .npmrcを編集し、あなたのNPM_TOKENを追加する

# テストを実行する
npm test

# プロジェクトをビルドする
npm run build

公開

パッケージを公開するには、以下の手順を行います。

1. .npmrc.exampleを.npmrcにコピーします。
2. あなたのnpm認証トークンを.npmrcに追加します。
3. npm publish --access publicを実行します。

⚠️ 重要提示

決して.npmrcファイル内の認証トークンをコミットしないでください。すでに.gitignoreに追加されています。

貢献方法

1. リポジトリをフォークしてクローンします。
2. 機能ブランチを作成します（例：git checkout -b feature/amazing-feature）。
3. 変更をコミットします（例：git commit -m 'feat: 添加神奇功能'）。
4. ブランチにプッシュします（例：git push origin feature/amazing-feature）。
5. プルリクエストを作成します。

📄 ライセンス

MITライセンスです。詳細については、LICENSEファイルをご覧ください。

関連プロジェクト

• モデルコンテキストプロトコル
• Claude Desktop

サポート

バグレポートや機能要求については、オープン Issues を開いてください。