1
0
Fork 0
mirror of https://github.com/nix-community/home-manager.git synced 2025-11-08 19:46:05 +01:00

vscode: add mcp module integration

This commit is contained in:
Thierry Delafontaine 2025-10-27 12:15:04 +01:00 committed by Austin Horstman
parent c740351870
commit 9ff9a94fd4
7 changed files with 278 additions and 4 deletions

View file

@ -114,6 +114,33 @@ let
isPath = p: builtins.isPath p || lib.isStorePath p;
transformMcpServerForVscode =
name: server:
let
# Remove the disabled field from the server config
cleanServer = lib.filterAttrs (n: v: n != "disabled") server;
in
{
name = name;
value = {
enabled = !(server.disabled or false);
}
// (
if server ? url then
{
type = "http";
}
// cleanServer
else if server ? command then
{
type = "stdio";
}
// cleanServer
else
{ }
);
};
profileType = types.submodule {
options = {
userSettings = mkOption {
@ -154,6 +181,20 @@ let
'';
};
enableMcpIntegration = mkOption {
type = lib.types.bool;
default = false;
description = ''
Whether to integrate the MCP servers config from
{option}`programs.mcp.servers` into
{option}`programs.vscode.profiles.<name>.userMcp`.
Note: Settings defined in {option}`programs.mcp.servers` are merged
with {option}`programs.vscode.profiles.<name>.userMcp`, with VSCode
settings taking precedence.
'';
};
userMcp = mkOption {
type = types.either types.path jsonFormat.type;
default = { };
@ -459,10 +500,31 @@ in
if isPath v.userTasks then v.userTasks else jsonFormat.generate "vscode-user-tasks" v.userTasks;
})
(mkIf (v.userMcp != { }) {
"${mcpFilePath n}".source =
if isPath v.userMcp then v.userMcp else jsonFormat.generate "vscode-user-mcp" v.userMcp;
})
(mkIf
(
v.userMcp != { }
|| (v.enableMcpIntegration && config.programs.mcp.enable && config.programs.mcp.servers != { })
)
{
"${mcpFilePath n}".source =
if isPath v.userMcp then
v.userMcp
else
let
transformedMcpServers =
if v.enableMcpIntegration && config.programs.mcp.enable && config.programs.mcp.servers != { } then
lib.listToAttrs (lib.mapAttrsToList transformMcpServerForVscode config.programs.mcp.servers)
else
{ };
# Merge MCP servers: transformed servers + user servers, with user servers taking precedence
mergedServers = transformedMcpServers // ((v.userMcp.servers or { }));
# Merge all MCP config
mergedMcpConfig =
v.userMcp // (lib.optionalAttrs (mergedServers != { }) { servers = mergedServers; });
in
jsonFormat.generate "vscode-user-mcp" mergedMcpConfig;
}
)
(mkIf (v.keybindings != [ ]) {
"${keybindingsFilePath n}".source =

View file

@ -24,6 +24,8 @@ let
keybindings = import ./keybindings.nix;
tasks = import ./tasks.nix;
mcp = import ./mcp.nix;
mcp-integration = import ./mcp-integration.nix;
mcp-integration-with-override = import ./mcp-integration-with-override.nix;
update-checks = import ./update-checks.nix;
snippets = import ./snippets.nix;
};

View file

@ -0,0 +1,26 @@
{
"servers": {
"context7": {
"enabled": true,
"headers": {
"CONTEXT7_API_KEY": "{env:CONTEXT7_API_KEY}"
},
"type": "http",
"url": "https://mcp.context7.com/mcp"
},
"disabled-server": {
"command": "echo",
"enabled": false,
"type": "stdio"
},
"everything": {
"args": [
"-y",
"@modelcontextprotocol/server-everything"
],
"command": "npx",
"enabled": true,
"type": "stdio"
}
}
}

View file

@ -0,0 +1,7 @@
{
"servers": {
"Github": {
"url": "https://api.githubcopilot.com/mcp/"
}
}
}

View file

@ -0,0 +1,25 @@
{
"servers": {
"CustomServer": {
"type": "http",
"url": "https://example.com/mcp"
},
"context7": {
"enabled": true,
"headers": {
"CONTEXT7_API_KEY": "{env:CONTEXT7_API_KEY}"
},
"type": "http",
"url": "https://mcp.context7.com/mcp"
},
"everything": {
"args": [
"-y",
"@modelcontextprotocol/server-everything"
],
"command": "custom-npx",
"enabled": false,
"type": "stdio"
}
}
}

View file

@ -0,0 +1,79 @@
package:
{
config,
pkgs,
lib,
...
}:
let
cfg = config.programs.vscode;
willUseIfd = package.pname != "vscode";
mcpFilePath =
name:
if pkgs.stdenv.hostPlatform.isDarwin then
"Library/Application Support/${cfg.nameShort}/User/${
lib.optionalString (name != "default") "profiles/${name}/"
}mcp.json"
else
".config/${cfg.nameShort}/User/${
lib.optionalString (name != "default") "profiles/${name}/"
}mcp.json";
in
lib.mkIf (willUseIfd -> config.test.enableLegacyIfd) {
programs.mcp = {
enable = true;
servers = {
everything = {
command = "npx";
args = [
"-y"
"@modelcontextprotocol/server-everything"
];
};
context7 = {
url = "https://mcp.context7.com/mcp";
headers = {
CONTEXT7_API_KEY = "{env:CONTEXT7_API_KEY}";
};
};
};
};
programs.vscode = {
enable = true;
inherit package;
profiles = {
default = {
enableMcpIntegration = true;
# User MCP settings should override generated ones
userMcp = {
servers = {
everything = {
command = "custom-npx";
args = [
"-y"
"@modelcontextprotocol/server-everything"
];
enabled = false;
type = "stdio";
};
CustomServer = {
type = "http";
url = "https://example.com/mcp";
};
};
};
};
};
};
nmt.script = ''
assertFileExists "home-files/${mcpFilePath "default"}"
assertFileContent "home-files/${mcpFilePath "default"}" ${./mcp-integration-with-override.json}
'';
}

View file

@ -0,0 +1,73 @@
package:
{
config,
pkgs,
lib,
...
}:
let
cfg = config.programs.vscode;
willUseIfd = package.pname != "vscode";
mcpFilePath =
name:
if pkgs.stdenv.hostPlatform.isDarwin then
"Library/Application Support/${cfg.nameShort}/User/${
lib.optionalString (name != "default") "profiles/${name}/"
}mcp.json"
else
".config/${cfg.nameShort}/User/${
lib.optionalString (name != "default") "profiles/${name}/"
}mcp.json";
in
lib.mkIf (willUseIfd -> config.test.enableLegacyIfd) {
programs.mcp = {
enable = true;
servers = {
everything = {
command = "npx";
args = [
"-y"
"@modelcontextprotocol/server-everything"
];
};
context7 = {
url = "https://mcp.context7.com/mcp";
headers = {
CONTEXT7_API_KEY = "{env:CONTEXT7_API_KEY}";
};
};
disabled-server = {
command = "echo";
disabled = true;
};
};
};
programs.vscode = {
enable = true;
inherit package;
profiles = {
default.enableMcpIntegration = true;
test.userMcp = {
servers = {
Github = {
url = "https://api.githubcopilot.com/mcp/";
};
};
};
};
};
nmt.script = ''
assertFileExists "home-files/${mcpFilePath "default"}"
assertFileContent "home-files/${mcpFilePath "default"}" ${./mcp-integration-default.json}
assertFileExists "home-files/${mcpFilePath "test"}"
assertFileContent "home-files/${mcpFilePath "test"}" ${./mcp-integration-test.json}
'';
}