Terminal MCP Server

🚀 ターミナルMCPサーバー

このリポジトリには、ターミナルコマンドのモデルコンテキストプロトコル（MCP）サーバーの実装が含まれています。

🚀 クイックスタート

✨ 主な機能

このサーバーを使用することで、Claudeが指定されたディレクトリ内でターミナルコマンドを実行できるようになります。

📦 インストール

前提条件

• Node.js (v16以上)
• npm (v7以上)

ローカルインストール

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

git clone https://github.com/algae514/terminal-mcp-server.git
cd terminal-mcp-server

2. 依存関係をインストールします：

npm install

3. プロジェクトをビルドします：

npm run build

4. 起動スクリプトを実行可能にします：

chmod +x start-server.sh

設定

このサーバーをClaudeと一緒に使用するには、Claudeの設定ファイルを更新してターミナルMCPサーバーを含める必要があります。

Claudeの設定ファイル（通常は ~/.config/claude/claude_desktop_config.json または同様の場所にあります）を更新して、以下の内容を含めます：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/directory1",
        "/path/to/directory2",
        "/path/to/directory3"
      ]
    },
    "terminal": {
      "command": "/path/to/terminal-mcp-server/start-server.sh",
      "args": []
    }
  }
}

/path/to/directory1、/path/to/directory2 などを、Claudeにアクセスさせたいディレクトリに置き換えてください。

/path/to/terminal-mcp-server を、実際にクローンしたリポジトリの場所に置き換えてください。

💻 使用例

基本的な使用法

設定が完了すると、ClaudeはターミナルMCPサーバーを介して指定されたディレクトリ内でターミナルコマンドを実行できます。

🔧 セキュリティに関する注意事項

• ターミナルが特定のディレクトリでコマンドを実行できるようにするには、maven - tool.jsonファイルにそれらの場所を指定する必要があります。サンプルURLは既に提供されています。
• Claudeに公開するディレクトリには特に注意してください。Claudeはそのような場所でコマンドを実行できるためです。
• サーバーを実行するために、制限された権限を持つ専用ユーザーを使用することを検討してください。
• Claudeが実行するコマンドを確認し、安全かつ適切であることを確認してください。

📄 ライセンス

MIT License