[FEATURE]: Add Project-level MCP Support

[magicds]

Feature hasn't been suggested before.

• I have verified this feature I'm about to request hasn't been suggested before.

Describe the enhancement you want to request

Background

Currently, OpenCode uses global MCP server configuration, but there are limitations:

1. Project-specific MCPs: Some MCP servers are only relevant to specific projects
2. Per-project authentication: Different projects may require different authentication configurations for the same MCP server (e.g., GitLab MCP with different tokens for different repositories)

Solution

OpenCode should support project-level MCP configuration, similar to Claude Code's implementation documented at https://code.claude.com/docs/en/mcp#project-scope

Users should be able to create a .mcp.json file in the project root directory with project-specific MCP server configurations.

Example .mcp.json file:

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": ["-y", "@zereight/mcp-gitlab"],
      "env": {
        "GITLAB_TOKEN": "project-specific-token"
      }
    },
    "custom-tool": {
      "command": "node",
      "args": ["/path/to/project-specific/mcp/server"],
      "env": {}
    }
  }
}

[github-actions]

This issue might be a duplicate of existing issues. Please check:

• How can I disable a specific MCP service for a specific model? #9801: How can I disable a specific MCP service for a specific model? (addresses model-specific MCP configuration needs)
• Running multiple instances of same MCP server with different configs? #9634: Running multiple instances of same MCP server with different configs? (addresses per-project MCP instance management)
• [FEATURE]: Allow configuring project-specific LSP servers (e.g., basedpyright instead of pyright) #9472: Allow configuring project-specific LSP servers (similar pattern for project-level tool configuration)
• [FEATURE]: Add @ mention syntax for one-time MCP server activation in chat #9696: Add @ mention syntax for one-time MCP server activation (alternative approach for project/request-specific MCP control)

Feel free to ignore if none of these address your specific case.

[magicds]

I couldn't find a related feature request Issue, but I did locate an already implemented pull request for this functionality.
722

[sunxyw]

I believe you are able to do so by putting a opencode.json with mcps config in your project root, which will be merged with the global config.

[magicds]

I believe you are able to do so by putting a opencode.json with mcps config in your project root, which will be merged with the global config.

Thank you so much! This is incredibly helpful.