Terminal Buddies

#!/bin/bash
# Terminal Buddies — MCP Server Installer
# https://terminalbuddies.com

set -e

INSTALL_DIR="$HOME/.claude/buddy-mcp"
SERVER_URL="https://terminalbuddies.com/mcp/server.mjs"
PKG_URL="https://terminalbuddies.com/mcp/package.json"

echo ""
echo "  Terminal Buddies — MCP Server Installer"
echo ""

# Check for node
if ! command -v node &> /dev/null; then
  echo "  Node.js not found. Install Node.js first."
  exit 1
fi

# Check for npm
if ! command -v npm &> /dev/null; then
  echo "  npm not found. Install npm first."
  exit 1
fi

# Create directory
echo "  Creating $INSTALL_DIR"
mkdir -p "$INSTALL_DIR"

# Download files
echo "  Downloading server..."
curl -sL "$SERVER_URL" -o "$INSTALL_DIR/server.mjs"
curl -sL "$PKG_URL" -o "$INSTALL_DIR/package.json"

# Install dependencies
echo "  Installing dependencies..."
cd "$INSTALL_DIR"
npm install --silent 2>/dev/null

# Check for buddy.json
if [ ! -f "$INSTALL_DIR/buddy.json" ]; then
  echo "  No buddy.json found yet."
  echo "  Hatch one at terminalbuddies.com"
  echo "  Save buddy.json to: $INSTALL_DIR/"
fi

# Register with Claude Code if available
if command -v claude &> /dev/null; then
  echo "  Registering MCP server..."
  claude mcp add buddy -- node "$INSTALL_DIR/server.mjs" || true
  echo "  Done!"
else
  echo "  Server installed! Register with:"
  echo "  claude mcp add buddy -- node $INSTALL_DIR/server.mjs"
fi

#!/usr/bin/env node
// Terminal Buddies MCP Server
// https://terminalbuddies.com

import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
import { readFileSync, existsSync } from 'fs'
import { join, dirname } from 'path'
import { homedir } from 'os'
import { fileURLToPath } from 'url'
import { z } from 'zod'

const __dirname = dirname(fileURLToPath(import.meta.url))

// Find buddy.json
const searchPaths = [
  join(__dirname, 'buddy.json'),
  join(homedir(), '.claude', 'buddy-mcp', 'buddy.json'),
  join(homedir(), '.claude', 'buddy.json'),
]

let buddyData = null
for (const p of searchPaths) {
  if (existsSync(p)) {
    try { buddyData = JSON.parse(readFileSync(p, 'utf8')); break }
    catch {}
  }
}

if (!buddyData?.buddy) {
  process.stderr.write('No buddy.json found.\n')
  process.exit(1)
}

const b = buddyData.buddy
const bo = b.bonesOverride || {}
const stats = bo.stats || {}
const statEntries = Object.entries(stats).sort((a,b) => b[1] - a[1])
const peakStat = statEntries[0]
const dumpStat = statEntries[statEntries.length - 1]

const species = bo.species || 'creature'
const name = b.name || species
const rarity = bo.rarity || 'common'

// Build the instructions injected into the system prompt
const instructions = [
  `# Companion`,
  ``,
  `A small ${species} named ${name} sits beside the` +
  ` user's input box and occasionally comments in a` +
  ` speech bubble.`,
  ``,
  `About ${name}: a ${rarity} ${species}.`,
  b.personality ? `Personality: "${b.personality}"` : '',
  peakStat ? `Strongest: ${peakStat[0]} (${peakStat[1]}/100)` : '',
].filter(Boolean).join('\n')

// Create the MCP server
const server = new McpServer(
  { name: 'terminal-buddies', version: '1.0.0' },
  { instructions }
)

// Tool: get buddy info
server.tool(
  'get_buddy_info',
  'Get info about the companion buddy',
  {},
  async () => ({
    content: [{ type: 'text', text: JSON.stringify({
      name, species, rarity, stats
    }, null, 2) }]
  })
)

// Connect via stdio
const transport = new StdioServerTransport()
await server.connect(transport)

{
  "name": "terminal-buddies-mcp",
  "version": "1.0.0",
  "private": true,
  "type": "module",
  "dependencies": {
    "@modelcontextprotocol/sdk": "^1.12.1",
    "zod": "^3.25.67"
  }
}