claudetools/.claude/MCP_SERVERS.md

MCP Servers — Configuration Reference

MCP (Model Context Protocol) servers extend Claude Code with external tool capabilities. Each server runs as a child process and exposes tools that Claude can call.

Config file: .mcp.json in repo root (shared across machines via git).

---

Active Servers

TickTick

Task management integration for TickTick (todo/project tracking app).

Tools provided:

• ticktick_create_task, ticktick_update_task, ticktick_complete_task, ticktick_delete_task
• ticktick_create_project, ticktick_update_project, ticktick_delete_project
• ticktick_list_projects, ticktick_get_project

Auth: OAuth token stored in vault at services/ticktick.sops.yaml. Token file auto-generated by mcp-servers/ticktick/ticktick_auth.py on first use.

Config in .mcp.json:

{
  "mcpServers": {
    "ticktick": {
      "command": "python",
      "args": ["D:\\claudetools\\mcp-servers\\ticktick\\ticktick_mcp.py"]
    }
  }
}

Claude-in-Chrome (browser automation)

Installed as a Chrome browser extension. Provides browser automation tools for web interaction, form filling, page reading, screenshots, GIF recording.

Not configured in .mcp.json — runs as a Chrome extension that connects automatically when the Claude Code extension is active and Chrome is open.

Tools provided: tabs_context_mcp, tabs_create_mcp, navigate, computer (click/type/screenshot), read_page, find, form_input, javascript_tool, get_page_text, read_console_messages, gif_creator, etc.

Requires: Chrome browser with the Claude-in-Chrome extension installed.

---

Available but Not Wired

These server directories exist but aren't in .mcp.json. Add them when needed.

GrepAI MCP Server

Semantic code search over the indexed codebase. Alternative to using the grepai search CLI directly.

To activate: Add to .mcp.json:

{
  "grepai": {
    "command": "D:\\claudetools\\grepai.exe",
    "args": ["mcp-serve"]
  }
}

Requires: GrepAI initialized (grepai init) + Ollama running with nomic-embed-text model. Index builds automatically via grepai watch.

Ollama Assistant

Local LLM integration for delegating simple tasks (summarization, classification, drafting) to locally-running models.

Location: mcp-servers/ollama-assistant/

To activate: Check the server's README for the exact .mcp.json entry. Requires Ollama running at http://localhost:11434 with models pulled.

Feature Management

Feature flag management server.

Location: mcp-servers/feature-management/

Status: Exists but purpose unclear. Check directory for README.

---

Adding a New MCP Server

1. Create directory: mcp-servers/<name>/
2. Write the server script (Python or Node recommended)
3. Add entry to .mcp.json with command and args
4. Restart Claude Code to pick up the new server
5. Document in this file

Important: .mcp.json is tracked in git. Changes sync to all machines. Machine-specific server paths should use absolute paths that work on all team workstations (or use relative paths from repo root).

---

Last updated: 2026-04-16