@autodev/context-mcp

Model Context Protocol implementation for AutoDev.

Using in cursor

{
  "mcpServers": {
    "autodev-context-mcp": {
      "command": "npx",
      "args": ["--package=@autodev/context-mcp", "autodev-context-mcp", "--preset=AutoDev"]
    }
  }
}

Local Using

{
  "mcpServers": {
    "autodev": {
      "command": "node",
      "args": ["/Users/phodal/ai/autodev-work/packages/context-mcp/dist/index.js", "--preset=AutoDev"],
      "env": {
        "PROJECT_ID": "xxx"
      }
    }
  }
}

Installation

npm install @autodev/context-mcp
# or
yarn add @autodev/context-mcp
# or
pnpm add @autodev/context-mcp

Usage

import { MCPServer } from "@autodev/context-mcp";

// Create a server instance
const server = new MCPServer({
  name: "my-server",
  version: "1.0.0",
});

server.serveHttp({
  port: 3000,
});

Available Tools

POSIX Command Line Tools

• ls - List directory contents

  // Example: List files in a directory
  const result = await server.tool("ls", { path: "./src" });

• cat - Concatenate and display file contents

  // Example: Display file contents
  const result = await server.tool("cat", { path: "./package.json" });

• grep - Search for patterns in files

  // Example: Search for a pattern
  const result = await server.tool("grep", { 
    pattern: "function", 
    path: "./src/**/*.ts" 
  });

• head - Display first lines of files

  // Example: Show first 10 lines
  const result = await server.tool("head", { 
    path: "./large-file.txt",
    lines: 10 
  });

• tail - Display last lines of files

  // Example: Show last 20 lines
  const result = await server.tool("tail", { 
    path: "./log.txt",
    lines: 20 
  });

• tee - Read from stdin and write to stdout and files

  // Example: Write to multiple files
  const result = await server.tool("tee", {
    paths: ["./output1.txt", "./output2.txt"],
    input: "Hello, World!"
  });

• sort - Sort text files

  // Example: Sort lines numerically
  const result = await server.tool("sort", {
    path: "./numbers.txt",
    numeric: true
  });

• uniq - Report or filter out repeated lines

  // Example: Show unique lines with counts
  const result = await server.tool("uniq", {
    path: "./duplicates.txt",
    count: true
  });

• cut - Remove sections from each line

  // Example: Extract first and third fields
  const result = await server.tool("cut", {
    path: "./data.txt",
    fields: "1,3",
    delimiter: ","
  });

• paste - Merge lines of files

  // Example: Merge two files side by side
  const result = await server.tool("paste", {
    paths: ["./file1.txt", "./file2.txt"]
  });

• diff - Compare files line by line

  // Example: Compare two files
  const result = await server.tool("diff", {
    file1: "./old.txt",
    file2: "./new.txt"
  });

• free - Display memory usage

  // Example: Show memory usage in human-readable format
  const result = await server.tool("free", {
    humanReadable: true
  });

• df - Display disk space usage

  // Example: Show disk usage for local filesystems
  const result = await server.tool("df", {
    local: true,
    humanReadable: true
  });

• find - Search for files

  // Example: Find all TypeScript files
  const result = await server.tool("find", {
    path: "./src",
    pattern: "*.ts"
  });

• wc - Count lines, words, and characters

  // Example: Count lines and words
  const result = await server.tool("wc", {
    path: "./text.txt",
    lines: true,
    words: true
  });

Code Search Tools

• ast_grep - Search code using AST patterns

  // Example: Find all function declarations
  const result = await server.tool("ast_grep", {
    pattern: "function $FUNC()",
    path: "./src"
  });

• rip_grep - Fast text-based code search

  // Example: Search for a specific string
  const result = await server.tool("rip_grep", {
    pattern: "TODO",
    path: "./src"
  });

Repository Tools

• GitHub PR Tools

  • List pull requests

  const result = await server.tool("github_pr_list", {
    owner: "username",
    repo: "repository"
  });

  • Create pull requests

  const result = await server.tool("github_pr_create", {
    owner: "username",
    repo: "repository",
    title: "New Feature",
    body: "Description",
    head: "feature-branch",
    base: "main"
  });

• GitLab MR Tools

  • List merge requests

  const result = await server.tool("gitlab_mr_list", {
    projectId: "123",
    state: "opened"
  });

  • Create merge requests

  const result = await server.tool("gitlab_mr_create", {
    projectId: "123",
    title: "New Feature",
    description: "Description",
    sourceBranch: "feature-branch",
    targetBranch: "main"
  });

Development

# Install dependencies
pnpm install

# Build the package
pnpm build

# Run tests
pnpm test

License

MIT