Skip to content

cianfhoghlaim/cianchosaint / .agents/skills/agent-observability

agent-observability

Unverified

references/mcp/MCP_SERVERS.md

View on GitHub
# MCP Servers — Full Configuration Reference

All Model Context Protocol (MCP) servers configured in `opencode.json` for the Kings' College Galway project. These servers expose tools to agents for code search, knowledge graph queries, web scraping, browser automation, database queries, and secret management.

## Server Inventory

| Server | Type | Port | Purpose | MCP Package |
|:--|:--|:--|:--|:--|
| `cocoindex-code` | local | — | Semantic code search | `ccc mcp` |
| `cognee` | local | 8100 | Document ingestion + GraphRAG | `cognee-mcp` |
| `graphiti` | local | 8000 | Temporal knowledge graph | `graphiti_core.mcp` |
| `langfuse` | local | — | LLM trace observability | `@langfuse/mcp` |
| `motherduck` | local | — | SQL analytics | `mcp-server-motherduck` |
| `firecrawl` | local | — | Web scraping | `firecrawl-mcp` |
| `browserbase` | local | — | Browser automation | `@browserbasehq/mcp` |
| `chrome` | local | — | Chrome DevTools | `chrome-devtools-mcp` |
| `infisical` | local | 8081 | Secret management | `@infisical/mcp` |

## Configuration — `opencode.json`

### Cognee — Document Cognition + GraphRAG

```json
"cognee": {
  "type": "local",
  "command": ["uvx", "cognee-mcp"],
  "env": {
    "COGNEE_API_URL": "http://localhost:8100",
    "COGNEE_API_KEY": "infisical://dev-baile/cognee/api_key",
    "LLM_API_KEY": "infisical://dev-baile/deepseek/api_key"
  },
  "enabled": true
}
```

**Prerequisites**: Cognee Docker container running on port 8100.

**Agent tools exposed**:
- `cognee_add(document, dataset)` — Add documents to Cognee
- `cognee_cognify(dataset)` — Build knowledge graph
- `cognee_search(query, search_type)` — Search graph (GRAPH_COMPLETION, CHUNKS, INSIGHTS, SUMMARIES)

### CCC — Semantic Code Search

```json
"cocoindex-code": {
  "type": "local",
  "command": ["ccc", "mcp"],
  "enabled": true
}
```

**Prerequisites**: `.cocoindex_code/target_sqlite.db` index database.

**Agent tools exposed**:
- `cocoindex-code_search(query, limit, languages, paths)` — Semantic code search
- Index refresh is automatic on each search

### Graphiti — Temporal Knowledge Graph

```json
"graphiti": {
  "type": "local",
  "command": ["uv", "run", "python", "-m", "graphiti_core.mcp"],
  "env": {
    "NEO4J_URI": "bolt://localhost:7687",
    "NEO4J_USER": "neo4j",
    "NEO4J_PASSWORD": "devpassword"
  },
  "enabled": true
}
```

**Prerequisites**: Graphiti server running on port 8000 with Neo4j backend.

**Agent tools exposed**:
- `graphiti_search(query)` — Temporal knowledge graph search
- `graphiti_get_node(id)` — Retrieve specific graph node
- `graphiti_get_edges(node_id)` — Get relationships for a node

### Langfuse — LLM Trace Observability

```json
"langfuse": {
  "type": "local",
  "command": ["bunx", "-y", "@langfuse/mcp"],
  "env": {
    "LANGFUSE_PUBLIC_KEY": "infisical://dev-baile/langfuse/public_key",
    "LANGFUSE_SECRET_KEY": "infisical://dev-baile/langfuse/secret_key",
    "LANGFUSE_HOST": "https://langfuse.cianfhoghlaim.ie"
  },
  "enabled": true
}
```

**Prerequisites**: Langfuse stack running (port 3000).

**Agent tools exposed**:
- `langfuse_get_trace(trace_id)` — Retrieve LLM call trace
- `langfuse_get_traces(project_id)` — List recent traces
- `langfuse_get_prompt(prompt_name)` — Retrieve prompt template

### MotherDuck — SQL Analytics

```json
"motherduck": {
  "type": "local",
  "command": ["uvx", "mcp-server-motherduck", "--db-path", ":memory:", "--read-write", "--allow-switch-databases"],
  "env": {
    "MOTHERDUCK_TOKEN": "infisical://dev-baile/motherduck/token"
  },
  "enabled": true
}
```

**Agent tools exposed**:
- `motherduck_execute_query(sql)` — Execute SQL query
- `motherduck_list_tables()` — List available tables
- `motherduck_list_databases()` — List databases

### Firecrawl — Web Scraping

```json
"firecrawl": {
  "type": "local",
  "command": ["bunx", "-y", "firecrawl-mcp"],
  "env": {
    "FIRECRAWL_API_KEY": "infisical://dev-baile/firecrawl/api_key"
  },
  "enabled": true
}
```

**Agent tools exposed**:
- `firecrawl_scrape(url, formats)` — Scrape a single page
- `firecrawl_search(query)` — Search the web
- `firecrawl_crawl(url)` — Crawl a website
- `firecrawl_map(url)` — Map site URLs

### Browserbase — Browser Automation

```json
"browserbase": {
  "type": "local",
  "command": ["bunx", "-y", "@browserbasehq/mcp", "--modelName", "deepseek/deepseek-chat", "--experimental"],
  "env": {
    "BROWSERBASE_API_KEY": "infisical://dev-baile/browserbase/api_key",
    "BROWSERBASE_PROJECT_ID": "infisical://dev-baile/browserbase/project_id",
    "DEEPSEEK_API_KEY": "infisical://dev-baile/deepseek/api_key"
  },
  "enabled": true
}
```

**Agent tools exposed**:
- `browserbase_navigate(url)` — Navigate to URL
- `browserbase_act(action)` — Perform action on page
- `browserbase_extract(instruction)` — Extract structured data
- `browserbase_observe(instruction)` — Observe actionable elements

### Chrome — Local DevTools

```json
"chrome": {
  "type": "local",
  "command": ["bunx", "-y", "chrome-devtools-mcp"],
  "enabled": true
}
```

**Agent tools exposed**:
- `chrome_navigate_page(url)` — Navigate in Chrome
- `chrome_take_screenshot()` — Capture page screenshot
- `chrome_take_snapshot()` — Get accessibility tree
- `chrome_evaluate_script(js)` — Run JavaScript

### Infisical — Secret Management

```json
"infisical": {
  "type": "local",
  "command": ["bunx", "-y", "@infisical/mcp"],
  "env": {
    "INFISICAL_UNIVERSAL_AUTH_CLIENT_ID": "${INFISICAL_CLIENT_ID}",
    "INFISICAL_UNIVERSAL_AUTH_CLIENT_SECRET": "${INFISICAL_CLIENT_SECRET}",
    "INFISICAL_HOST_URL": "http://localhost:8081",
    "INFISICAL_PROJECT_ID": "${INFISICAL_PROJECT_ID}"
  },
  "enabled": true
}
```

**Agent tools exposed**:
- `infisical_get_secret(name)` — Retrieve a secret
- `infisical_list_secrets()` — List all secrets
- `infisical_create_secret(name, value)` — Create new secret

## MCP Activation Flow

```
1. opencode starts → reads opencode.json
2. For each "enabled": true MCP server:
   a. Resolves Infisical URI references (infisical://...)
   b. Installs package if needed (bunx/uvx auto-install)
   c. Starts MCP server subprocess
   d. Registers tools from MCP server
3. Agents can now call tools from all registered MCP servers
```

## Adding a New MCP Server

```json
"new-server": {
  "type": "local",
  "command": ["bunx", "-y", "new-mcp-package"],
  "env": {
    "API_KEY": "infisical://dev-baile/new-server/api_key",
    "API_URL": "http://localhost:PORT"
  },
  "enabled": true
}
```

1. Add the block to `opencode.json` under `"mcp"`
2. Add any needed secrets to Infisical vault
3. Add the Infisical reference to `.infisical.env`
4. Run `bun run secrets:init` to hydrate
5. Restart opencode to pick up the new server
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall