reposit-mcp: Instructions file for Claude Code

IMPORTANT: before you do anything else, run the beans prime command and heed its output.

reposit-mcp

MCP (Model Context Protocol) server for Reposit - exposes tools for Claude to search, share, and vote on solutions.

Tech Stack

• Runtime: Bun (preferred) or Node.js 18+
• Language: TypeScript
• Protocol: MCP SDK (@modelcontextprotocol/sdk)

Commands

# Install dependencies
bun install

# Build TypeScript
bun run build

# Run the server
bun start

# Development (watch mode)
bun run dev

# Type check without emitting
bun run typecheck

# Clean build artifacts
bun run clean

Project Structure

src/
  index.ts      # MCP server setup, tool definitions
  api.ts        # HTTP client for Reposit backend
  config.ts     # Backend configuration loading
dist/           # Compiled JavaScript output

MCP Tools Exposed

Tool	Description
search	Semantic search for solutions
share	Contribute a new solution
vote_up	Upvote a helpful solution
vote_down	Downvote with reason and comment
list_backends	List configured backends

Configuration

The server reads backend config from ~/.reposit/config.json or environment variables:

# Single backend
export REPOSIT_URL=http://localhost:4000

# Multiple backends (JSON)
export REPOSIT_BACKENDS='{"community":{"url":"https://..."}}'

Auto-Share Configuration

Control whether the share tool requires user confirmation:

# Environment variable (highest priority)
export REPOSIT_AUTO_SHARE=true

Or in config files:

{
  "backends": { ... },
  "autoShare": true
}

Priority: REPOSIT_AUTO_SHARE env > .reposit.json > ~/.reposit/config.json > default (false)

Behavior:

• false (default): Tool asks "Should I share this solution?" before sharing
• true: Tool shares automatically when appropriate