Add comprehensive MCP loader documentation
- Added 'MCP LOADER (claude-code-mcp-loader)' section to src/features/AGENTS.md - Documented .mcp.json file locations with priority order (user, project, local) - Specified .mcp.json format with complete structure and examples - Documented server types (stdio, http, sse) with required fields - Added environment variable expansion syntax documentation - Provided practical examples for stdio, http, and disabled servers - Added transformation reference table for Claude Code → OpenCode format - Improved discoverability for users setting up MCP servers via Claude Code configuration 🤖 GENERATED WITH ASSISTANCE OF [OhMyOpenCode](https://github.com/code-yeongyu/oh-my-opencode)
This commit is contained in:
@@ -77,6 +77,116 @@ Disable features in `oh-my-opencode.json`:
|
||||
- **Timing**: PreToolUse, PostToolUse, UserPromptSubmit, Stop
|
||||
- **Format**: Returns `{ messages: [{ role: "user", content: "..." }] }`
|
||||
|
||||
## MCP LOADER (claude-code-mcp-loader)
|
||||
|
||||
Loads MCP server configs from `.mcp.json` files. Full Claude Code compatibility.
|
||||
|
||||
### File Locations (Priority Order)
|
||||
|
||||
| Path | Scope | Description |
|
||||
|------|-------|-------------|
|
||||
| `~/.claude/.mcp.json` | user | User-global MCP servers |
|
||||
| `./.mcp.json` | project | Project-specific MCP servers |
|
||||
| `./.claude/.mcp.json` | local | Local overrides (git-ignored) |
|
||||
|
||||
### .mcp.json Format
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"server-name": {
|
||||
"type": "stdio|http|sse",
|
||||
"command": "npx",
|
||||
"args": ["-y", "@anthropics/mcp-server-example"],
|
||||
"env": {
|
||||
"API_KEY": "${MY_API_KEY}"
|
||||
},
|
||||
"disabled": false
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Server Types
|
||||
|
||||
| Type | Required Fields | Description |
|
||||
|------|-----------------|-------------|
|
||||
| `stdio` (default) | `command`, `args?`, `env?` | Local subprocess MCP |
|
||||
| `http` | `url`, `headers?` | HTTP-based remote MCP |
|
||||
| `sse` | `url`, `headers?` | SSE-based remote MCP |
|
||||
|
||||
### Environment Variable Expansion
|
||||
|
||||
Supports `${VAR}` syntax in all string fields:
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"my-server": {
|
||||
"command": "node",
|
||||
"args": ["${HOME}/mcp-server/index.js"],
|
||||
"env": {
|
||||
"API_KEY": "${MY_API_KEY}",
|
||||
"DEBUG": "${DEBUG:-false}"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Examples
|
||||
|
||||
**stdio (Local subprocess)**:
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"filesystem": {
|
||||
"command": "npx",
|
||||
"args": ["-y", "@anthropics/mcp-server-filesystem", "/path/to/dir"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**http (Remote)**:
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"remote-api": {
|
||||
"type": "http",
|
||||
"url": "https://mcp.example.com/api",
|
||||
"headers": {
|
||||
"Authorization": "Bearer ${API_TOKEN}"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Disable a server**:
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"expensive-server": {
|
||||
"command": "...",
|
||||
"disabled": true
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Transformation
|
||||
|
||||
Claude Code format → OpenCode format:
|
||||
|
||||
| Claude Code | OpenCode |
|
||||
|-------------|----------|
|
||||
| `type: "stdio"` | `type: "local"` |
|
||||
| `type: "http\|sse"` | `type: "remote"` |
|
||||
| `command` + `args` | `command: [cmd, ...args]` |
|
||||
| `env` | `environment` |
|
||||
| `headers` | `headers` |
|
||||
|
||||
## SKILL MCP MANAGER
|
||||
|
||||
- **Purpose**: Manage MCP servers embedded in skill YAML frontmatter
|
||||
|
||||
Reference in New Issue
Block a user