Mike Swanson
100a491ac6
Two session logs: - session-logs/2026-04-16-session.md: cross-cutting (multi-user, audit, infrastructure) - guru-rmm session log appended: MSI installer, Len's Auto Brokerage, Uranus, migration drift Gap fixes: GrepAI initialized + MCP server added, Ollama models pulling, settings.json created (bypassPermissions), MCP_SERVERS.md written. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
110 lines
3.1 KiB
Markdown
110 lines
3.1 KiB
Markdown
# 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`:**
|
|
```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`:
|
|
```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*
|