Tmux MCP Server

Instructions

Implementation Reference

• src/index.ts:237-255 (handler)

  MCP tool handler function for "kill-session". Takes sessionId, calls tmux.killSession, returns success or error message.

  async ({ sessionId }) => {
    try {
      await tmux.killSession(sessionId);
      return {
        content: [{
          type: "text",
          text: `Session ${sessionId} has been killed`
        }]
      };
    } catch (error) {
      return {
        content: [{
          type: "text",
          text: `Error killing session: ${error}`
        }],
        isError: true
      };
    }
  }

• src/index.ts:234-236 (schema)

  Input schema for kill-session tool using Zod: requires sessionId as string.

  {
    sessionId: z.string().describe("ID of the tmux session to kill")
  },

• src/index.ts:231-256 (registration)

  Registration of the "kill-session" tool on the MCP server with name, description, schema, and handler.

  server.tool(
    "kill-session",
    "Kill a tmux session by ID",
    {
      sessionId: z.string().describe("ID of the tmux session to kill")
    },
    async ({ sessionId }) => {
      try {
        await tmux.killSession(sessionId);
        return {
          content: [{
            type: "text",
            text: `Session ${sessionId} has been killed`
          }]
        };
      } catch (error) {
        return {
          content: [{
            type: "text",
            text: `Error killing session: ${error}`
          }],
          isError: true
        };
      }
    }
  );

• src/tmux.ts:179-181 (helper)

  Helper function killSession that executes the tmux 'kill-session' command via executeTmux.

  export async function killSession(sessionId: string): Promise<void> {
    await executeTmux(`kill-session -t '${sessionId}'`);
  }