@thantos66/claude-context-mcp 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +171 -0
  3. package/dist/constants.d.ts +33 -0
  4. package/dist/constants.js +59 -0
  5. package/dist/constants.js.map +1 -0
  6. package/dist/index.d.ts +2 -0
  7. package/dist/index.js +44 -0
  8. package/dist/index.js.map +1 -0
  9. package/dist/schemas/agent-frontmatter.d.ts +55 -0
  10. package/dist/schemas/agent-frontmatter.js +43 -0
  11. package/dist/schemas/agent-frontmatter.js.map +1 -0
  12. package/dist/schemas/mcp-config.d.ts +177 -0
  13. package/dist/schemas/mcp-config.js +38 -0
  14. package/dist/schemas/mcp-config.js.map +1 -0
  15. package/dist/schemas/settings.d.ts +70 -0
  16. package/dist/schemas/settings.js +28 -0
  17. package/dist/schemas/settings.js.map +1 -0
  18. package/dist/schemas/skill-frontmatter.d.ts +42 -0
  19. package/dist/schemas/skill-frontmatter.js +27 -0
  20. package/dist/schemas/skill-frontmatter.js.map +1 -0
  21. package/dist/services/agents.d.ts +56 -0
  22. package/dist/services/agents.js +155 -0
  23. package/dist/services/agents.js.map +1 -0
  24. package/dist/services/atomic-write.d.ts +10 -0
  25. package/dist/services/atomic-write.js +46 -0
  26. package/dist/services/atomic-write.js.map +1 -0
  27. package/dist/services/backup.d.ts +13 -0
  28. package/dist/services/backup.js +52 -0
  29. package/dist/services/backup.js.map +1 -0
  30. package/dist/services/mcp-config.d.ts +72 -0
  31. package/dist/services/mcp-config.js +163 -0
  32. package/dist/services/mcp-config.js.map +1 -0
  33. package/dist/services/paths.d.ts +42 -0
  34. package/dist/services/paths.js +91 -0
  35. package/dist/services/paths.js.map +1 -0
  36. package/dist/services/permissions.d.ts +38 -0
  37. package/dist/services/permissions.js +104 -0
  38. package/dist/services/permissions.js.map +1 -0
  39. package/dist/services/skills.d.ts +62 -0
  40. package/dist/services/skills.js +181 -0
  41. package/dist/services/skills.js.map +1 -0
  42. package/dist/tools/agents.d.ts +2 -0
  43. package/dist/tools/agents.js +134 -0
  44. package/dist/tools/agents.js.map +1 -0
  45. package/dist/tools/helpers.d.ts +25 -0
  46. package/dist/tools/helpers.js +36 -0
  47. package/dist/tools/helpers.js.map +1 -0
  48. package/dist/tools/mcp.d.ts +2 -0
  49. package/dist/tools/mcp.js +257 -0
  50. package/dist/tools/mcp.js.map +1 -0
  51. package/dist/tools/meta.d.ts +2 -0
  52. package/dist/tools/meta.js +79 -0
  53. package/dist/tools/meta.js.map +1 -0
  54. package/dist/tools/permissions.d.ts +2 -0
  55. package/dist/tools/permissions.js +144 -0
  56. package/dist/tools/permissions.js.map +1 -0
  57. package/dist/tools/skills.d.ts +2 -0
  58. package/dist/tools/skills.js +160 -0
  59. package/dist/tools/skills.js.map +1 -0
  60. package/package.json +55 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/tools/mcp.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ export declare function registerMetaTools(server: McpServer): void;
@@ -0,0 +1,79 @@
1
+ import { z } from "zod";
2
+ import fs from "node:fs/promises";
3
+ import { allPlatformPaths } from "../services/paths.js";
4
+ import { loadMcpConfig } from "../services/mcp-config.js";
5
+ import { loadSettings } from "../services/permissions.js";
6
+ import { backupFile } from "../services/backup.js";
7
+ import { handle, okResponse } from "./helpers.js";
8
+ export function registerMetaTools(server) {
9
+ // ------------------------------------------------------------------
10
+ // meta_platform_paths
11
+ // ------------------------------------------------------------------
12
+ server.registerTool("meta_platform_paths", {
13
+ title: "Show resolved config paths",
14
+ description: "Return the absolute paths this tool would read/write for the " +
15
+ "current OS, for each scope (and an optional project path).",
16
+ inputSchema: {
17
+ projectPath: z.string().optional(),
18
+ },
19
+ annotations: {
20
+ readOnlyHint: true,
21
+ destructiveHint: false,
22
+ idempotentHint: true,
23
+ openWorldHint: false,
24
+ },
25
+ }, async ({ projectPath }) => {
26
+ const paths = allPlatformPaths(projectPath);
27
+ return okResponse(JSON.stringify(paths, null, 2), paths);
28
+ });
29
+ // ------------------------------------------------------------------
30
+ // meta_validate
31
+ // ------------------------------------------------------------------
32
+ server.registerTool("meta_validate", {
33
+ title: "Validate a config file",
34
+ description: "Parse and validate a config file without writing. Supported kinds: " +
35
+ "`mcp-config` (claude_desktop_config.json, .mcp.json, ~/.claude.json) " +
36
+ "and `settings` (.claude/settings.json).",
37
+ inputSchema: {
38
+ kind: z.enum(["mcp-config", "settings"]),
39
+ filePath: z.string(),
40
+ },
41
+ annotations: {
42
+ readOnlyHint: true,
43
+ destructiveHint: false,
44
+ idempotentHint: true,
45
+ openWorldHint: false,
46
+ },
47
+ }, async ({ kind, filePath }) => handle(async () => {
48
+ if (kind === "mcp-config") {
49
+ const parsed = await loadMcpConfig(filePath);
50
+ return { ok: true, kind, filePath, parsed };
51
+ }
52
+ const parsed = await loadSettings(filePath);
53
+ return { ok: true, kind, filePath, parsed };
54
+ }, (result) => okResponse(`validated ${result.kind} at ${result.filePath}\n\n${JSON.stringify(result.parsed, null, 2)}`, result)));
55
+ // ------------------------------------------------------------------
56
+ // meta_backup_file
57
+ // ------------------------------------------------------------------
58
+ server.registerTool("meta_backup_file", {
59
+ title: "Manually back up a config file",
60
+ description: "Snapshot a given config file into ~/.claude/backups/. Useful before " +
61
+ "a risky sequence of edits outside this tool.",
62
+ inputSchema: {
63
+ filePath: z.string(),
64
+ },
65
+ annotations: {
66
+ readOnlyHint: false,
67
+ destructiveHint: false,
68
+ idempotentHint: false,
69
+ openWorldHint: false,
70
+ },
71
+ }, async ({ filePath }) => handle(async () => {
72
+ await fs.access(filePath);
73
+ const backup = await backupFile(filePath);
74
+ return { filePath, backup };
75
+ }, (result) => result.backup
76
+ ? okResponse(`backed up ${result.filePath} -> ${result.backup}`, result)
77
+ : okResponse(`no-op: ${result.filePath} did not exist`, result)));
78
+ }
79
+ //# sourceMappingURL=meta.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/tools/meta.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ export declare function registerPermissionsTools(server: McpServer): void;
@@ -0,0 +1,144 @@
1
+ import { z } from "zod";
2
+ import { listPermissions, addRules, removeRule, setDefaultMode, } from "../services/permissions.js";
3
+ import { DefaultModeSchema } from "../schemas/settings.js";
4
+ import { handle, okResponse, formatWriteResult } from "./helpers.js";
5
+ const CodeScope = z.enum(["user", "project"]);
6
+ const ListName = z.enum(["allow", "deny", "ask"]);
7
+ const ProjectPathField = {
8
+ projectPath: z
9
+ .string()
10
+ .optional()
11
+ .describe("Absolute path to the project. Required when scope=project."),
12
+ };
13
+ const DryRunField = {
14
+ dryRun: z
15
+ .boolean()
16
+ .optional()
17
+ .describe("If true, return the diff of what would be written without touching disk."),
18
+ };
19
+ export function registerPermissionsTools(server) {
20
+ // ------------------------------------------------------------------
21
+ // permissions_list
22
+ // ------------------------------------------------------------------
23
+ server.registerTool("permissions_list", {
24
+ title: "List permission rules",
25
+ description: "Return the allow/deny/ask arrays and defaultMode for a Claude Code scope.",
26
+ inputSchema: {
27
+ scope: CodeScope,
28
+ ...ProjectPathField,
29
+ },
30
+ annotations: {
31
+ readOnlyHint: true,
32
+ destructiveHint: false,
33
+ idempotentHint: true,
34
+ openWorldHint: false,
35
+ },
36
+ }, async ({ scope, projectPath }) => handle(() => listPermissions(scope, projectPath), (result) => {
37
+ const p = result.permissions;
38
+ const text = [
39
+ `path: ${result.path}`,
40
+ `defaultMode: ${result.defaultMode ?? "(unset)"}`,
41
+ `allow (${p.allow.length}):${formatList(p.allow)}`,
42
+ `deny (${p.deny.length}):${formatList(p.deny)}`,
43
+ `ask (${p.ask.length}):${formatList(p.ask)}`,
44
+ ].join("\n");
45
+ return okResponse(text, { ...result });
46
+ }));
47
+ // ------------------------------------------------------------------
48
+ // permissions_add_rules
49
+ // ------------------------------------------------------------------
50
+ server.registerTool("permissions_add_rules", {
51
+ title: "Add permission rules",
52
+ description: 'Add one or more rules to allow/deny/ask. Rules use Claude Code grammar: ' +
53
+ 'e.g. "Bash(npm run *)", "Read(./.env)", "mcp__github__*", "Agent(my-agent)". ' +
54
+ "Duplicates are skipped. Eval order: deny > ask > allow.",
55
+ inputSchema: {
56
+ scope: CodeScope,
57
+ list: ListName,
58
+ rules: z.array(z.string().min(1)).min(1),
59
+ ...ProjectPathField,
60
+ ...DryRunField,
61
+ },
62
+ annotations: {
63
+ readOnlyHint: false,
64
+ destructiveHint: false,
65
+ idempotentHint: true,
66
+ openWorldHint: false,
67
+ },
68
+ }, async (args) => handle(() => addRules({
69
+ scope: args.scope,
70
+ list: args.list,
71
+ rules: args.rules,
72
+ projectPath: args.projectPath,
73
+ dryRun: args.dryRun,
74
+ }), (result) => {
75
+ const head = formatWriteResult(result, `add ${args.list} rules to`, false);
76
+ const detail = [
77
+ ` added (${result.added.length}):${formatList(result.added)}`,
78
+ ` already present (${result.alreadyPresent.length}):${formatList(result.alreadyPresent)}`,
79
+ ].join("\n");
80
+ return okResponse(`${head}\n${detail}`, { result });
81
+ }));
82
+ // ------------------------------------------------------------------
83
+ // permissions_remove_rule
84
+ // ------------------------------------------------------------------
85
+ server.registerTool("permissions_remove_rule", {
86
+ title: "Remove a permission rule",
87
+ description: "Remove a rule (by exact string match) from the specified list in a scope.",
88
+ inputSchema: {
89
+ scope: CodeScope,
90
+ list: ListName,
91
+ rule: z.string().min(1),
92
+ ...ProjectPathField,
93
+ ...DryRunField,
94
+ },
95
+ annotations: {
96
+ readOnlyHint: false,
97
+ destructiveHint: true,
98
+ idempotentHint: true,
99
+ openWorldHint: false,
100
+ },
101
+ }, async (args) => handle(() => removeRule({
102
+ scope: args.scope,
103
+ list: args.list,
104
+ rule: args.rule,
105
+ projectPath: args.projectPath,
106
+ dryRun: args.dryRun,
107
+ }), (result) => {
108
+ const verb = result.removed
109
+ ? `remove ${args.list} rule ${JSON.stringify(args.rule)} from`
110
+ : `[not found] remove ${args.list} rule ${JSON.stringify(args.rule)} from`;
111
+ return okResponse(formatWriteResult(result, verb, false), { result });
112
+ }));
113
+ // ------------------------------------------------------------------
114
+ // permissions_set_default_mode
115
+ // ------------------------------------------------------------------
116
+ server.registerTool("permissions_set_default_mode", {
117
+ title: "Set default permission mode",
118
+ description: "Set `defaultMode` on a Claude Code settings.json. Valid values: " +
119
+ "default, acceptEdits, plan, auto, dontAsk, bypassPermissions.",
120
+ inputSchema: {
121
+ scope: CodeScope,
122
+ mode: DefaultModeSchema,
123
+ ...ProjectPathField,
124
+ ...DryRunField,
125
+ },
126
+ annotations: {
127
+ readOnlyHint: false,
128
+ destructiveHint: false,
129
+ idempotentHint: true,
130
+ openWorldHint: false,
131
+ },
132
+ }, async (args) => handle(() => setDefaultMode({
133
+ scope: args.scope,
134
+ mode: args.mode,
135
+ projectPath: args.projectPath,
136
+ dryRun: args.dryRun,
137
+ }), (result) => okResponse(formatWriteResult(result, `set defaultMode=${args.mode} in`, false), { result })));
138
+ }
139
+ function formatList(items) {
140
+ if (items.length === 0)
141
+ return " (none)";
142
+ return "\n" + items.map((r) => ` - ${r}`).join("\n");
143
+ }
144
+ //# sourceMappingURL=permissions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../src/tools/permissions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,eAAe,EACf,QAAQ,EACR,UAAU,EACV,cAAc,GACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAC9C,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AAElD,MAAM,gBAAgB,GAAG;IACvB,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4DAA4D,CAAC;CAC1E,CAAC;AAEF,MAAM,WAAW,GAAG;IAClB,MAAM,EAAE,CAAC;SACN,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,0EAA0E,CAAC;CACxF,CAAC;AAEF,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,qEAAqE;IACrE,mBAAmB;IACnB,qEAAqE;IACrE,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EACT,2EAA2E;QAC7E,WAAW,EAAE;YACX,KAAK,EAAE,SAAS;YAChB,GAAG,gBAAgB;SACpB;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,CAC/B,MAAM,CACJ,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,WAAW,CAAC,EACzC,CAAC,MAAM,EAAE,EAAE;QACT,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC;QAC7B,MAAM,IAAI,GAAG;YACX,SAAS,MAAM,CAAC,IAAI,EAAE;YACtB,gBAAgB,MAAM,CAAC,WAAW,IAAI,SAAS,EAAE;YACjD,UAAU,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE;YAClD,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE;YAChD,UAAU,CAAC,CAAC,GAAG,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE;SAC/C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,OAAO,UAAU,CAAC,IAAI,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC,CACF,CACJ,CAAC;IAEF,qEAAqE;IACrE,wBAAwB;IACxB,qEAAqE;IACrE,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,0EAA0E;YAC1E,+EAA+E;YAC/E,yDAAyD;QAC3D,WAAW,EAAE;YACX,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACxC,GAAG,gBAAgB;YACnB,GAAG,WAAW;SACf;QACD,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,MAAM,CACJ,GAAG,EAAE,CACH,QAAQ,CAAC;QACP,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,EACJ,CAAC,MAAM,EAAE,EAAE;QACT,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,EAAE,OAAO,IAAI,CAAC,IAAI,WAAW,EAAE,KAAK,CAAC,CAAC;QAC3E,MAAM,MAAM,GAAG;YACb,YAAY,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;YAC9D,sBAAsB,MAAM,CAAC,cAAc,CAAC,MAAM,KAAK,UAAU,CAC/D,MAAM,CAAC,cAAc,CACtB,EAAE;SACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,OAAO,UAAU,CAAC,GAAG,IAAI,KAAK,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACtD,CAAC,CACF,CACJ,CAAC;IAEF,qEAAqE;IACrE,0BAA0B;IAC1B,qEAAqE;IACrE,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,2EAA2E;QAC7E,WAAW,EAAE;YACX,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACvB,GAAG,gBAAgB;YACnB,GAAG,WAAW;SACf;QACD,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,MAAM,CACJ,GAAG,EAAE,CACH,UAAU,CAAC;QACT,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,EACJ,CAAC,MAAM,EAAE,EAAE;QACT,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO;YACzB,CAAC,CAAC,UAAU,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO;YAC9D,CAAC,CAAC,sBAAsB,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;QAC7E,OAAO,UAAU,CAAC,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC,CACF,CACJ,CAAC;IAEF,qEAAqE;IACrE,+BAA+B;IAC/B,qEAAqE;IACrE,MAAM,CAAC,YAAY,CACjB,8BAA8B,EAC9B;QACE,KAAK,EAAE,6BAA6B;QACpC,WAAW,EACT,kEAAkE;YAClE,+DAA+D;QACjE,WAAW,EAAE;YACX,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,iBAAiB;YACvB,GAAG,gBAAgB;YACnB,GAAG,WAAW;SACf;QACD,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,MAAM,CACJ,GAAG,EAAE,CACH,cAAc,CAAC;QACb,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,EACJ,CAAC,MAAM,EAAE,EAAE,CACT,UAAU,CACR,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,IAAI,CAAC,IAAI,KAAK,EAAE,KAAK,CAAC,EACnE,EAAE,MAAM,EAAE,CACX,CACJ,CACJ,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAe;IACjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,OAAO,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC"}
@@ -0,0 +1,2 @@
1
+ import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ export declare function registerSkillTools(server: McpServer): void;
@@ -0,0 +1,160 @@
1
+ import { z } from "zod";
2
+ import { listSkills, getSkill, createSkill, updateSkill, setSkillEnabled, deleteSkill, } from "../services/skills.js";
3
+ import { handle, okResponse, formatWriteResult } from "./helpers.js";
4
+ const CodeScope = z.enum(["user", "project"]);
5
+ const ProjectPathField = {
6
+ projectPath: z
7
+ .string()
8
+ .optional()
9
+ .describe("Absolute path to the project. Required when scope=project."),
10
+ };
11
+ const DryRunField = { dryRun: z.boolean().optional() };
12
+ export function registerSkillTools(server) {
13
+ // ------------------------------------------------------------------
14
+ // skill_list
15
+ // ------------------------------------------------------------------
16
+ server.registerTool("skill_list", {
17
+ title: "List skills",
18
+ description: "List skills in a scope with their name and description.",
19
+ inputSchema: {
20
+ scope: CodeScope,
21
+ ...ProjectPathField,
22
+ },
23
+ annotations: {
24
+ readOnlyHint: true,
25
+ destructiveHint: false,
26
+ idempotentHint: true,
27
+ openWorldHint: false,
28
+ },
29
+ }, async ({ scope, projectPath }) => handle(() => listSkills(scope, projectPath), (skills) => okResponse(skills.length === 0
30
+ ? `No skills found in ${scope} scope.`
31
+ : skills
32
+ .map((s) => `[${s.scope}] ${s.name}${s.frontmatter["disable-model-invocation"] ? " (disabled)" : ""}\n dir: ${s.dir}\n description: ${truncate(s.frontmatter.description, 120)}`)
33
+ .join("\n\n"), {
34
+ skills: skills.map((s) => ({
35
+ ...s,
36
+ body: truncate(s.body, 200),
37
+ })),
38
+ })));
39
+ // ------------------------------------------------------------------
40
+ // skill_get
41
+ // ------------------------------------------------------------------
42
+ server.registerTool("skill_get", {
43
+ title: "Get a skill",
44
+ description: "Return the full SKILL.md (frontmatter + body) for a skill.",
45
+ inputSchema: {
46
+ scope: CodeScope,
47
+ name: z.string().min(1),
48
+ ...ProjectPathField,
49
+ },
50
+ annotations: {
51
+ readOnlyHint: true,
52
+ destructiveHint: false,
53
+ idempotentHint: true,
54
+ openWorldHint: false,
55
+ },
56
+ }, async (args) => handle(() => getSkill(args), (rec) => rec
57
+ ? okResponse(`[${rec.scope}] ${rec.name}\n dir: ${rec.dir}\n\n--- frontmatter ---\n${JSON.stringify(rec.frontmatter, null, 2)}\n\n--- body ---\n${rec.body}`, { skill: rec })
58
+ : okResponse(`Skill "${args.name}" not found.`, { found: false })));
59
+ // ------------------------------------------------------------------
60
+ // skill_create
61
+ // ------------------------------------------------------------------
62
+ server.registerTool("skill_create", {
63
+ title: "Create a skill",
64
+ description: "Scaffold a new skill folder containing SKILL.md. The folder is " +
65
+ "created at <scope-skills-dir>/<name>/. Supports dry-run.",
66
+ inputSchema: {
67
+ scope: CodeScope,
68
+ name: z
69
+ .string()
70
+ .regex(/^[a-z0-9][a-z0-9-]*$/, "skill name must be lowercase alphanumeric + hyphens"),
71
+ description: z.string().min(1),
72
+ allowedTools: z
73
+ .string()
74
+ .optional()
75
+ .describe('Frontmatter `allowed-tools` string, e.g. "Bash(git *) Read"'),
76
+ model: z.string().optional(),
77
+ body: z.string().optional(),
78
+ overwrite: z.boolean().optional(),
79
+ ...ProjectPathField,
80
+ ...DryRunField,
81
+ },
82
+ annotations: {
83
+ readOnlyHint: false,
84
+ destructiveHint: false,
85
+ idempotentHint: false,
86
+ openWorldHint: false,
87
+ },
88
+ }, async (args) => handle(() => createSkill(args), (result) => okResponse(formatWriteResult(result, `create skill "${args.name}" at`, false), { result })));
89
+ // ------------------------------------------------------------------
90
+ // skill_update
91
+ // ------------------------------------------------------------------
92
+ server.registerTool("skill_update", {
93
+ title: "Update a skill",
94
+ description: "Patch frontmatter fields and/or replace the body of an existing SKILL.md.",
95
+ inputSchema: {
96
+ scope: CodeScope,
97
+ name: z.string().min(1),
98
+ description: z.string().optional(),
99
+ allowedTools: z.string().optional(),
100
+ model: z.string().optional(),
101
+ body: z.string().optional(),
102
+ ...ProjectPathField,
103
+ ...DryRunField,
104
+ },
105
+ annotations: {
106
+ readOnlyHint: false,
107
+ destructiveHint: false,
108
+ idempotentHint: true,
109
+ openWorldHint: false,
110
+ },
111
+ }, async (args) => handle(() => updateSkill(args), (result) => okResponse(formatWriteResult(result, `update skill "${args.name}" at`, false), { result })));
112
+ // ------------------------------------------------------------------
113
+ // skill_set_enabled
114
+ // ------------------------------------------------------------------
115
+ server.registerTool("skill_set_enabled", {
116
+ title: "Enable or disable a skill",
117
+ description: 'Toggle the `disable-model-invocation` frontmatter flag. Preserves files.',
118
+ inputSchema: {
119
+ scope: CodeScope,
120
+ name: z.string().min(1),
121
+ enabled: z.boolean(),
122
+ ...ProjectPathField,
123
+ ...DryRunField,
124
+ },
125
+ annotations: {
126
+ readOnlyHint: false,
127
+ destructiveHint: false,
128
+ idempotentHint: true,
129
+ openWorldHint: false,
130
+ },
131
+ }, async (args) => handle(() => setSkillEnabled(args), (result) => {
132
+ const verb = args.enabled ? "enable" : "disable";
133
+ return okResponse(formatWriteResult(result, `${verb} skill "${args.name}" at`, false), { result });
134
+ }));
135
+ // ------------------------------------------------------------------
136
+ // skill_delete
137
+ // ------------------------------------------------------------------
138
+ server.registerTool("skill_delete", {
139
+ title: "Delete a skill",
140
+ description: "Remove a skill folder entirely. The folder is snapshotted to backups first.",
141
+ inputSchema: {
142
+ scope: CodeScope,
143
+ name: z.string().min(1),
144
+ ...ProjectPathField,
145
+ ...DryRunField,
146
+ },
147
+ annotations: {
148
+ readOnlyHint: false,
149
+ destructiveHint: true,
150
+ idempotentHint: true,
151
+ openWorldHint: false,
152
+ },
153
+ }, async (args) => handle(() => deleteSkill(args), (result) => okResponse(formatWriteResult(result, `delete skill "${args.name}" at`, false), { result })));
154
+ }
155
+ function truncate(s, n) {
156
+ if (s.length <= n)
157
+ return s;
158
+ return s.slice(0, n - 1) + "…";
159
+ }
160
+ //# sourceMappingURL=skills.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/tools/skills.ts"],"names":[],"mappings":"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"}
package/package.json ADDED
@@ -0,0 +1,55 @@
1
+ {
2
+ "name": "@thantos66/claude-context-mcp",
3
+ "version": "0.1.0",
4
+ "description": "MCP server for managing Claude Code MCP servers, subagents, skills, and permissions across projects.",
5
+ "type": "module",
6
+ "bin": {
7
+ "claude-context-mcp": "dist/index.js"
8
+ },
9
+ "main": "dist/index.js",
10
+ "files": [
11
+ "dist",
12
+ "README.md",
13
+ "LICENSE"
14
+ ],
15
+ "keywords": [
16
+ "mcp",
17
+ "model-context-protocol",
18
+ "claude",
19
+ "claude-code",
20
+ "claude-desktop",
21
+ "anthropic",
22
+ "subagents",
23
+ "skills"
24
+ ],
25
+ "author": "Thantos66",
26
+ "license": "MIT",
27
+ "homepage": "https://github.com/Thantos66/claude-context-mcp#readme",
28
+ "repository": {
29
+ "type": "git",
30
+ "url": "git+https://github.com/Thantos66/claude-context-mcp.git"
31
+ },
32
+ "bugs": {
33
+ "url": "https://github.com/Thantos66/claude-context-mcp/issues"
34
+ },
35
+ "scripts": {
36
+ "build": "tsc",
37
+ "start": "node dist/index.js",
38
+ "dev": "tsc --watch",
39
+ "test": "vitest run",
40
+ "test:watch": "vitest"
41
+ },
42
+ "dependencies": {
43
+ "@modelcontextprotocol/sdk": "^1.0.4",
44
+ "gray-matter": "^4.0.3",
45
+ "zod": "^3.23.8"
46
+ },
47
+ "devDependencies": {
48
+ "@types/node": "^22.10.0",
49
+ "typescript": "^5.6.3",
50
+ "vitest": "^2.1.8"
51
+ },
52
+ "engines": {
53
+ "node": ">=18"
54
+ }
55
+ }