mcp-kira

An MCP (Model Context Protocol) server exposing a single tool run_static_analysis that runs:

pnpm lint:changed

It is designed to be used with Claude Desktop and runs over stdio. All logs are sent to stderr; the JSON‑RPC stream to Claude is kept on stdout.

Quick start (Claude Desktop)

1. Put this repo somewhere accessible (or publish it to npm/GitHub).

2. Add a server entry in your claude_desktop_config.json:

   {
     "mcpServers": {
       "kira-extension": {
         "command": "npx",
         "args": ["-y", "mcp-kira"],
         "env": {
           "PROJECT_ROOT": "/absolute/path/to/your/workspace",
           // Optional: override the command that will be executed
           "LINT_STAGED_CMD": "pnpm lint:changed"
         }
       }
     }
   }

   Tip: If you haven't published to npm yet, you can also point npx at a GitHub repo (e.g. "args": ["-y", "github:YOUR_USER/mcp-kira-server"]). The prepare script will build TypeScript during install.

3. In Claude, restart the app or reload MCP servers. You should see a new tool named run_static_analysis.

Environment

• PROJECT_ROOT (required): absolute or relative path to your repository root; the command runs only inside this directory.
• LINT_STAGED_CMD (optional): full command to run. Defaults to pnpm lint:changed.

Security notes

• The server chdirs into PROJECT_ROOT at startup and executes the command there.
• It never writes to stdout except MCP protocol messages; logs go to stderr.
• Output is returned as a JSON string with { stdout, stderr, exit_code }.

Local development

pnpm i
pnpm dev  # hot reload with tsx
pnpm build && node dist/index.js

How to publish

pnpm publish --access public