nexus-mcp-agent 0.1.2

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 (72) hide show
  1. package/.env.example +56 -0
  2. package/README.md +74 -0
  3. package/dist/core/config.d.ts +46 -0
  4. package/dist/core/config.d.ts.map +1 -0
  5. package/dist/core/config.js +68 -0
  6. package/dist/core/config.js.map +1 -0
  7. package/dist/core/logger.d.ts +7 -0
  8. package/dist/core/logger.d.ts.map +1 -0
  9. package/dist/core/logger.js +54 -0
  10. package/dist/core/logger.js.map +1 -0
  11. package/dist/core/registry.d.ts +21 -0
  12. package/dist/core/registry.d.ts.map +1 -0
  13. package/dist/core/registry.js +52 -0
  14. package/dist/core/registry.js.map +1 -0
  15. package/dist/core/server.d.ts +12 -0
  16. package/dist/core/server.d.ts.map +1 -0
  17. package/dist/core/server.js +120 -0
  18. package/dist/core/server.js.map +1 -0
  19. package/dist/index.d.ts +3 -0
  20. package/dist/index.d.ts.map +1 -0
  21. package/dist/index.js +38 -0
  22. package/dist/index.js.map +1 -0
  23. package/dist/tools/agents/index.d.ts +18 -0
  24. package/dist/tools/agents/index.d.ts.map +1 -0
  25. package/dist/tools/agents/index.js +134 -0
  26. package/dist/tools/agents/index.js.map +1 -0
  27. package/dist/tools/automation/index.d.ts +4 -0
  28. package/dist/tools/automation/index.d.ts.map +1 -0
  29. package/dist/tools/automation/index.js +95 -0
  30. package/dist/tools/automation/index.js.map +1 -0
  31. package/dist/tools/filesystem/index.d.ts +4 -0
  32. package/dist/tools/filesystem/index.d.ts.map +1 -0
  33. package/dist/tools/filesystem/index.js +261 -0
  34. package/dist/tools/filesystem/index.js.map +1 -0
  35. package/dist/tools/git/index.d.ts +4 -0
  36. package/dist/tools/git/index.d.ts.map +1 -0
  37. package/dist/tools/git/index.js +177 -0
  38. package/dist/tools/git/index.js.map +1 -0
  39. package/dist/tools/memory/index.d.ts +4 -0
  40. package/dist/tools/memory/index.d.ts.map +1 -0
  41. package/dist/tools/memory/index.js +178 -0
  42. package/dist/tools/memory/index.js.map +1 -0
  43. package/dist/tools/system/index.d.ts +4 -0
  44. package/dist/tools/system/index.d.ts.map +1 -0
  45. package/dist/tools/system/index.js +121 -0
  46. package/dist/tools/system/index.js.map +1 -0
  47. package/dist/tools/terminal/index.d.ts +4 -0
  48. package/dist/tools/terminal/index.d.ts.map +1 -0
  49. package/dist/tools/terminal/index.js +86 -0
  50. package/dist/tools/terminal/index.js.map +1 -0
  51. package/dist/tools/web/index.d.ts +4 -0
  52. package/dist/tools/web/index.d.ts.map +1 -0
  53. package/dist/tools/web/index.js +193 -0
  54. package/dist/tools/web/index.js.map +1 -0
  55. package/docs/SECURITY.md +31 -0
  56. package/mcp-config.json +9 -0
  57. package/package.json +65 -0
  58. package/scripts/setup.js +102 -0
  59. package/src/core/config.ts +138 -0
  60. package/src/core/logger.ts +61 -0
  61. package/src/core/registry.ts +72 -0
  62. package/src/core/server.ts +144 -0
  63. package/src/index.ts +46 -0
  64. package/src/tools/agents/index.ts +172 -0
  65. package/src/tools/automation/index.ts +127 -0
  66. package/src/tools/filesystem/index.ts +303 -0
  67. package/src/tools/git/index.ts +201 -0
  68. package/src/tools/memory/index.ts +204 -0
  69. package/src/tools/system/index.ts +140 -0
  70. package/src/tools/terminal/index.ts +105 -0
  71. package/src/tools/web/index.ts +224 -0
  72. package/tsconfig.json +30 -0
@@ -0,0 +1,177 @@
1
+ import { z } from 'zod/v3';
2
+ import simpleGit from 'simple-git';
3
+ import { createContextLogger, logAudit } from '../../core/logger.js';
4
+ const log = createContextLogger('tools/git');
5
+ function getGit(cwd) {
6
+ return simpleGit(cwd || process.cwd());
7
+ }
8
+ const GitCwdSchema = z.object({
9
+ cwd: z.string().optional(),
10
+ });
11
+ const GitDiffSchema = z.object({
12
+ cwd: z.string().optional(),
13
+ staged: z.boolean().optional().default(false),
14
+ });
15
+ const GitLogSchema = z.object({
16
+ cwd: z.string().optional(),
17
+ maxCount: z.number().optional().default(20),
18
+ });
19
+ const GitCommitSchema = z.object({
20
+ message: z.string(),
21
+ cwd: z.string().optional(),
22
+ all: z.boolean().optional().default(false),
23
+ });
24
+ const GitPushSchema = z.object({
25
+ cwd: z.string().optional(),
26
+ remote: z.string().optional(),
27
+ branch: z.string().optional(),
28
+ });
29
+ const GitPullSchema = z.object({
30
+ cwd: z.string().optional(),
31
+ remote: z.string().optional(),
32
+ branch: z.string().optional(),
33
+ });
34
+ const GitBranchSchema = z.object({
35
+ cwd: z.string().optional(),
36
+ name: z.string().optional(),
37
+ checkout: z.boolean().optional().default(false),
38
+ });
39
+ async function gitStatus(params) {
40
+ try {
41
+ const git = getGit(params.cwd);
42
+ const status = await git.status();
43
+ return { success: true, ...status };
44
+ }
45
+ catch (error) {
46
+ return { success: false, error: error.message };
47
+ }
48
+ }
49
+ async function gitDiff(params) {
50
+ try {
51
+ const git = getGit(params.cwd);
52
+ const diff = params.staged ? await git.diff(['--staged']) : await git.diff();
53
+ return { success: true, diff };
54
+ }
55
+ catch (error) {
56
+ return { success: false, error: error.message };
57
+ }
58
+ }
59
+ async function gitLog(params) {
60
+ try {
61
+ const git = getGit(params.cwd);
62
+ const log_ = await git.log({ maxCount: params.maxCount || 20 });
63
+ return { success: true, commits: log_.all };
64
+ }
65
+ catch (error) {
66
+ return { success: false, error: error.message };
67
+ }
68
+ }
69
+ async function gitCommit(params) {
70
+ logAudit('git_commit', { message: params.message, cwd: params.cwd });
71
+ try {
72
+ const git = getGit(params.cwd);
73
+ if (params.all)
74
+ await git.add('.');
75
+ const result = await git.commit(params.message);
76
+ return { success: true, ...result };
77
+ }
78
+ catch (error) {
79
+ return { success: false, error: error.message };
80
+ }
81
+ }
82
+ async function gitPush(params) {
83
+ logAudit('git_push', { cwd: params.cwd });
84
+ try {
85
+ const git = getGit(params.cwd);
86
+ const result = await git.push(params.remote || 'origin', params.branch);
87
+ return { success: true, ...result };
88
+ }
89
+ catch (error) {
90
+ return { success: false, error: error.message };
91
+ }
92
+ }
93
+ async function gitPull(params) {
94
+ try {
95
+ const git = getGit(params.cwd);
96
+ const result = await git.pull(params.remote || 'origin', params.branch);
97
+ return { success: true, ...result };
98
+ }
99
+ catch (error) {
100
+ return { success: false, error: error.message };
101
+ }
102
+ }
103
+ async function gitBranch(params) {
104
+ try {
105
+ const git = getGit(params.cwd);
106
+ if (params.name) {
107
+ if (params.checkout) {
108
+ await git.checkoutLocalBranch(params.name);
109
+ return { success: true, message: `Created and checked out ${params.name}` };
110
+ }
111
+ else {
112
+ await git.branch([params.name]);
113
+ return { success: true, message: `Created branch ${params.name}` };
114
+ }
115
+ }
116
+ else {
117
+ const branches = await git.branch();
118
+ return { success: true, ...branches };
119
+ }
120
+ }
121
+ catch (error) {
122
+ return { success: false, error: error.message };
123
+ }
124
+ }
125
+ export function registerGitTools(server, registry) {
126
+ server.registerTool('git_status', {
127
+ description: 'Get git status',
128
+ inputSchema: GitCwdSchema,
129
+ }, async (params) => ({
130
+ content: [{ type: 'text', text: JSON.stringify(await gitStatus(params), null, 2) }],
131
+ }));
132
+ server.registerTool('git_diff', {
133
+ description: 'Get git diff',
134
+ inputSchema: GitDiffSchema,
135
+ }, async (params) => ({
136
+ content: [{ type: 'text', text: JSON.stringify(await gitDiff(params), null, 2) }],
137
+ }));
138
+ server.registerTool('git_log', {
139
+ description: 'Get git log',
140
+ inputSchema: GitLogSchema,
141
+ }, async (params) => ({
142
+ content: [{ type: 'text', text: JSON.stringify(await gitLog(params), null, 2) }],
143
+ }));
144
+ server.registerTool('git_commit', {
145
+ description: 'Create git commit',
146
+ inputSchema: GitCommitSchema,
147
+ }, async (params) => ({
148
+ content: [{ type: 'text', text: JSON.stringify(await gitCommit(params), null, 2) }],
149
+ }));
150
+ server.registerTool('git_push', {
151
+ description: 'Push to remote',
152
+ inputSchema: GitPushSchema,
153
+ }, async (params) => ({
154
+ content: [{ type: 'text', text: JSON.stringify(await gitPush(params), null, 2) }],
155
+ }));
156
+ server.registerTool('git_pull', {
157
+ description: 'Pull from remote',
158
+ inputSchema: GitPullSchema,
159
+ }, async (params) => ({
160
+ content: [{ type: 'text', text: JSON.stringify(await gitPull(params), null, 2) }],
161
+ }));
162
+ server.registerTool('git_branch', {
163
+ description: 'Create/list branches',
164
+ inputSchema: GitBranchSchema,
165
+ }, async (params) => ({
166
+ content: [{ type: 'text', text: JSON.stringify(await gitBranch(params), null, 2) }],
167
+ }));
168
+ registry.register({ name: 'git_status', category: 'git', description: 'Git status', handler: gitStatus });
169
+ registry.register({ name: 'git_diff', category: 'git', description: 'Git diff', handler: gitDiff });
170
+ registry.register({ name: 'git_log', category: 'git', description: 'Git log', handler: gitLog });
171
+ registry.register({ name: 'git_commit', category: 'git', description: 'Git commit', handler: gitCommit });
172
+ registry.register({ name: 'git_push', category: 'git', description: 'Git push', handler: gitPush });
173
+ registry.register({ name: 'git_pull', category: 'git', description: 'Git pull', handler: gitPull });
174
+ registry.register({ name: 'git_branch', category: 'git', description: 'Git branch', handler: gitBranch });
175
+ log.info('Registered 7 git tools');
176
+ }
177
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/git/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import { ToolRegistry } from '../../core/registry.js';
3
+ export declare function registerMemoryTools(server: McpServer, registry: ToolRegistry): void;
4
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AA6JtD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CA2CnF"}
@@ -0,0 +1,178 @@
1
+ import { z } from 'zod/v3';
2
+ import { ChromaClient } from 'chromadb';
3
+ import { createContextLogger } from '../../core/logger.js';
4
+ import { nexusConfig } from '../../core/config.js';
5
+ import { v4 as uuid } from 'uuid';
6
+ const log = createContextLogger('tools/memory');
7
+ let chromaClient = null;
8
+ let collection = null;
9
+ async function getCollection() {
10
+ if (collection)
11
+ return collection;
12
+ try {
13
+ chromaClient = new ChromaClient({ path: nexusConfig.vector.chromaUrl });
14
+ collection = await chromaClient.getOrCreateCollection({
15
+ name: nexusConfig.vector.collection,
16
+ metadata: { description: 'NEXUS long-term memory' },
17
+ });
18
+ return collection;
19
+ }
20
+ catch (error) {
21
+ log.warn(`ChromaDB not available: ${error.message}. Using in-memory fallback.`);
22
+ throw error;
23
+ }
24
+ }
25
+ const memoryFallback = new Map();
26
+ const MemoryStoreSchema = z.object({
27
+ content: z.string().describe('Content to remember'),
28
+ metadata: z.record(z.any()).optional().describe('Additional metadata'),
29
+ tags: z.array(z.string()).optional().describe('Tags for categorization'),
30
+ });
31
+ const MemorySearchSchema = z.object({
32
+ query: z.string().describe('Search query'),
33
+ limit: z.number().optional().default(10),
34
+ tags: z.array(z.string()).optional(),
35
+ });
36
+ const MemoryGetSchema = z.object({
37
+ id: z.string(),
38
+ });
39
+ const MemoryForgetSchema = z.object({
40
+ id: z.string(),
41
+ });
42
+ const MemoryListSchema = z.object({
43
+ limit: z.number().optional().default(50),
44
+ });
45
+ async function memoryStore(params) {
46
+ const { content, metadata = {}, tags = [] } = params;
47
+ const id = uuid();
48
+ const timestamp = Date.now();
49
+ log.info(`Storing memory: ${id} (${content.length} chars)`);
50
+ try {
51
+ const col = await getCollection();
52
+ await col.add({
53
+ ids: [id],
54
+ documents: [content],
55
+ metadatas: [{ ...metadata, tags: tags.join(','), timestamp }],
56
+ });
57
+ return { success: true, id, stored: 'chromadb' };
58
+ }
59
+ catch (error) {
60
+ memoryFallback.set(id, { content, metadata: { ...metadata, tags }, timestamp });
61
+ log.warn(`Stored in memory fallback: ${id}`);
62
+ return { success: true, id, stored: 'memory-fallback', warning: 'ChromaDB unavailable' };
63
+ }
64
+ }
65
+ async function memorySearch(params) {
66
+ const { query, limit = 10, tags = [] } = params;
67
+ log.info(`Searching memory: "${query}"`);
68
+ try {
69
+ const col = await getCollection();
70
+ const results = await col.query({
71
+ queryTexts: [query],
72
+ nResults: limit,
73
+ where: tags.length > 0 ? { tags: { $contains: tags.join(',') } } : undefined,
74
+ });
75
+ const memories = (results.documents[0] || []).map((doc, i) => ({
76
+ id: results.ids[0][i],
77
+ content: doc,
78
+ metadata: results.metadatas?.[0]?.[i],
79
+ distance: results.distances?.[0]?.[i],
80
+ }));
81
+ return { success: true, count: memories.length, results: memories };
82
+ }
83
+ catch (error) {
84
+ const results = Array.from(memoryFallback.entries())
85
+ .filter(([_, m]) => m.content.toLowerCase().includes(query.toLowerCase()))
86
+ .slice(0, limit)
87
+ .map(([id, m]) => ({ id, ...m }));
88
+ return { success: true, count: results.length, results, source: 'memory-fallback' };
89
+ }
90
+ }
91
+ async function memoryGet(params) {
92
+ try {
93
+ const col = await getCollection();
94
+ const result = await col.get({ ids: [params.id] });
95
+ if (result.documents.length === 0)
96
+ return { success: false, error: 'Not found' };
97
+ return { success: true, id: params.id, content: result.documents[0], metadata: result.metadatas?.[0] };
98
+ }
99
+ catch (error) {
100
+ const mem = memoryFallback.get(params.id);
101
+ if (!mem)
102
+ return { success: false, error: 'Not found' };
103
+ return { success: true, id: params.id, ...mem, source: 'memory-fallback' };
104
+ }
105
+ }
106
+ async function memoryForget(params) {
107
+ log.info(`Forgetting memory: ${params.id}`);
108
+ try {
109
+ const col = await getCollection();
110
+ await col.delete({ ids: [params.id] });
111
+ return { success: true };
112
+ }
113
+ catch (error) {
114
+ memoryFallback.delete(params.id);
115
+ return { success: true, source: 'memory-fallback' };
116
+ }
117
+ }
118
+ async function memoryList(params) {
119
+ const limit = params.limit || 50;
120
+ try {
121
+ const col = await getCollection();
122
+ const result = await col.get({ limit });
123
+ return {
124
+ success: true,
125
+ count: result.ids.length,
126
+ memories: result.ids.map((id, i) => ({
127
+ id,
128
+ preview: (result.documents[i] || '').slice(0, 200),
129
+ metadata: result.metadatas?.[i],
130
+ })),
131
+ };
132
+ }
133
+ catch (error) {
134
+ const memories = Array.from(memoryFallback.entries()).slice(0, limit).map(([id, m]) => ({
135
+ id, preview: m.content.slice(0, 200), metadata: m.metadata,
136
+ }));
137
+ return { success: true, count: memories.length, memories, source: 'memory-fallback' };
138
+ }
139
+ }
140
+ export function registerMemoryTools(server, registry) {
141
+ server.registerTool('memory_store', {
142
+ description: 'Store information in long-term memory',
143
+ inputSchema: MemoryStoreSchema,
144
+ }, async (params) => ({
145
+ content: [{ type: 'text', text: JSON.stringify(await memoryStore(params), null, 2) }],
146
+ }));
147
+ server.registerTool('memory_search', {
148
+ description: 'Search long-term memory',
149
+ inputSchema: MemorySearchSchema,
150
+ }, async (params) => ({
151
+ content: [{ type: 'text', text: JSON.stringify(await memorySearch(params), null, 2) }],
152
+ }));
153
+ server.registerTool('memory_get', {
154
+ description: 'Get specific memory by ID',
155
+ inputSchema: MemoryGetSchema,
156
+ }, async (params) => ({
157
+ content: [{ type: 'text', text: JSON.stringify(await memoryGet(params), null, 2) }],
158
+ }));
159
+ server.registerTool('memory_forget', {
160
+ description: 'Delete a memory',
161
+ inputSchema: MemoryForgetSchema,
162
+ }, async (params) => ({
163
+ content: [{ type: 'text', text: JSON.stringify(await memoryForget(params), null, 2) }],
164
+ }));
165
+ server.registerTool('memory_list', {
166
+ description: 'List recent memories',
167
+ inputSchema: MemoryListSchema,
168
+ }, async (params) => ({
169
+ content: [{ type: 'text', text: JSON.stringify(await memoryList(params), null, 2) }],
170
+ }));
171
+ registry.register({ name: 'memory_store', category: 'memory', description: 'Store memory', handler: memoryStore });
172
+ registry.register({ name: 'memory_search', category: 'memory', description: 'Search memory', handler: memorySearch });
173
+ registry.register({ name: 'memory_get', category: 'memory', description: 'Get memory', handler: memoryGet });
174
+ registry.register({ name: 'memory_forget', category: 'memory', description: 'Forget memory', handler: memoryForget });
175
+ registry.register({ name: 'memory_list', category: 'memory', description: 'List memories', handler: memoryList });
176
+ log.info('Registered 5 memory tools');
177
+ }
178
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/memory/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import { ToolRegistry } from '../../core/registry.js';
3
+ export declare function registerSystemTools(server: McpServer, registry: ToolRegistry): void;
4
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/system/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAoGtD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAqCnF"}
@@ -0,0 +1,121 @@
1
+ import { z } from 'zod/v3';
2
+ import { createContextLogger } from '../../core/logger.js';
3
+ import { nexusConfig } from '../../core/config.js';
4
+ const log = createContextLogger('tools/system');
5
+ const SENSITIVE_KEYS = ['OPENAI_API_KEY', 'ANTHROPIC_API_KEY', 'BRAVE_SEARCH_API_KEY', 'NEXUS_CONFIG'];
6
+ async function systemInfoFull() {
7
+ const os = await import('os');
8
+ return {
9
+ nexus: {
10
+ name: 'NEXUS',
11
+ version: '0.1.0',
12
+ uptime: process.uptime(),
13
+ memory: process.memoryUsage(),
14
+ },
15
+ system: {
16
+ platform: process.platform,
17
+ arch: process.arch,
18
+ nodeVersion: process.version,
19
+ hostname: os.hostname(),
20
+ uptime: os.uptime(),
21
+ cpus: os.cpus().length,
22
+ totalMemory: os.totalmem(),
23
+ freeMemory: os.freemem(),
24
+ },
25
+ config: {
26
+ llmProvider: nexusConfig.llm.provider,
27
+ llmModel: nexusConfig.llm.model,
28
+ searchProvider: nexusConfig.search.provider,
29
+ vectorDb: nexusConfig.vector.type,
30
+ allowedDirs: nexusConfig.security.allowedDirs,
31
+ },
32
+ };
33
+ }
34
+ const ConfigGetSchema = z.object({
35
+ key: z.string().optional(),
36
+ });
37
+ const ConfigSetSchema = z.object({
38
+ key: z.string(),
39
+ value: z.any(),
40
+ });
41
+ const EnvReadSchema = z.object({
42
+ key: z.string().optional(),
43
+ });
44
+ async function configGet(params) {
45
+ if (!params.key)
46
+ return { success: true, config: nexusConfig };
47
+ const keys = params.key.split('.');
48
+ let val = nexusConfig;
49
+ for (const k of keys) {
50
+ if (val && typeof val === 'object' && k in val)
51
+ val = val[k];
52
+ else
53
+ return { success: false, error: `Key not found: ${params.key}` };
54
+ }
55
+ return { success: true, key: params.key, value: val };
56
+ }
57
+ async function configSet(params) {
58
+ const { key, value } = params;
59
+ const keys = key.split('.');
60
+ let obj = nexusConfig;
61
+ for (let i = 0; i < keys.length - 1; i++) {
62
+ if (!obj[keys[i]] || typeof obj[keys[i]] !== 'object') {
63
+ return { success: false, error: `Invalid key path: ${key}` };
64
+ }
65
+ obj = obj[keys[i]];
66
+ }
67
+ obj[keys[keys.length - 1]] = value;
68
+ log.info(`Config updated: ${key} = ${JSON.stringify(value)}`);
69
+ return { success: true, key, value };
70
+ }
71
+ async function envRead(params) {
72
+ if (!params.key) {
73
+ const env = {};
74
+ for (const [k, v] of Object.entries(process.env)) {
75
+ if (!SENSITIVE_KEYS.includes(k)) {
76
+ env[k] = v;
77
+ }
78
+ }
79
+ return { success: true, env, filteredKeys: SENSITIVE_KEYS };
80
+ }
81
+ if (SENSITIVE_KEYS.includes(params.key)) {
82
+ return { success: false, error: `Access denied: ${params.key} is a sensitive key` };
83
+ }
84
+ return { success: true, key: params.key, value: process.env[params.key] };
85
+ }
86
+ async function ping() {
87
+ return { success: true, pong: true, timestamp: new Date().toISOString(), uptime: process.uptime() };
88
+ }
89
+ export function registerSystemTools(server, registry) {
90
+ server.tool('system_info_full', 'Get detailed system information', {}, async () => ({
91
+ content: [{ type: 'text', text: JSON.stringify(await systemInfoFull(), null, 2) }],
92
+ }));
93
+ server.registerTool('config_get', {
94
+ description: 'Get configuration value',
95
+ inputSchema: ConfigGetSchema,
96
+ }, async (params) => ({
97
+ content: [{ type: 'text', text: JSON.stringify(await configGet(params), null, 2) }],
98
+ }));
99
+ server.registerTool('config_set', {
100
+ description: 'Set configuration value',
101
+ inputSchema: ConfigSetSchema,
102
+ }, async (params) => ({
103
+ content: [{ type: 'text', text: JSON.stringify(await configSet(params), null, 2) }],
104
+ }));
105
+ server.registerTool('env_read', {
106
+ description: 'Read environment variable (sensitive keys filtered)',
107
+ inputSchema: EnvReadSchema,
108
+ }, async (params) => ({
109
+ content: [{ type: 'text', text: JSON.stringify(await envRead(params), null, 2) }],
110
+ }));
111
+ server.tool('ping', 'Health check', {}, async () => ({
112
+ content: [{ type: 'text', text: JSON.stringify(await ping(), null, 2) }],
113
+ }));
114
+ registry.register({ name: 'system_info_full', category: 'system', description: 'System info', handler: systemInfoFull });
115
+ registry.register({ name: 'config_get', category: 'system', description: 'Get config', handler: configGet });
116
+ registry.register({ name: 'config_set', category: 'system', description: 'Set config', handler: configSet });
117
+ registry.register({ name: 'env_read', category: 'system', description: 'Read env var', handler: envRead });
118
+ registry.register({ name: 'ping', category: 'system', description: 'Health check', handler: ping });
119
+ log.info('Registered 5 system tools');
120
+ }
121
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/system/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import { ToolRegistry } from '../../core/registry.js';
3
+ export declare function registerTerminalTools(server: McpServer, registry: ToolRegistry): void;
4
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/terminal/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AA+EtD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAqBrF"}
@@ -0,0 +1,86 @@
1
+ import { z } from 'zod/v3';
2
+ import { exec as execCb } from 'child_process';
3
+ import { promisify } from 'util';
4
+ import { createContextLogger, logAudit } from '../../core/logger.js';
5
+ import { nexusConfig } from '../../core/config.js';
6
+ const exec = promisify(execCb);
7
+ const log = createContextLogger('tools/terminal');
8
+ function isCommandBlocked(command) {
9
+ return nexusConfig.security.blockedCommands.some(blocked => command.toLowerCase().includes(blocked.toLowerCase()));
10
+ }
11
+ const ShellExecSchema = z.object({
12
+ command: z.string().describe('Command to execute'),
13
+ cwd: z.string().optional().describe('Working directory'),
14
+ timeout: z.number().optional().default(30000).describe('Timeout in ms'),
15
+ env: z.record(z.string()).optional().describe('Environment variables'),
16
+ });
17
+ async function shellExec(params) {
18
+ const { command, cwd, timeout = 30000, env = {} } = params;
19
+ if (isCommandBlocked(command)) {
20
+ logAudit('shell_exec_blocked', { command });
21
+ return { success: false, error: `Command blocked by security policy: ${command}` };
22
+ }
23
+ logAudit('shell_exec', { command, cwd });
24
+ log.info(`Executing: ${command}`);
25
+ try {
26
+ const { stdout, stderr } = await exec(command, {
27
+ cwd,
28
+ timeout,
29
+ env: { ...process.env, ...env },
30
+ maxBuffer: 10 * 1024 * 1024,
31
+ });
32
+ return { success: true, stdout, stderr, exitCode: 0 };
33
+ }
34
+ catch (error) {
35
+ return {
36
+ success: false,
37
+ stdout: error.stdout || '',
38
+ stderr: error.stderr || error.message,
39
+ exitCode: error.code || 1,
40
+ };
41
+ }
42
+ }
43
+ async function processList() {
44
+ try {
45
+ const isWindows = process.platform === 'win32';
46
+ const cmd = isWindows ? 'tasklist' : 'ps aux';
47
+ const { stdout } = await exec(cmd);
48
+ return { success: true, processes: stdout };
49
+ }
50
+ catch (error) {
51
+ return { success: false, error: error.message };
52
+ }
53
+ }
54
+ async function systemInfo() {
55
+ const os = await import('os');
56
+ return {
57
+ platform: process.platform,
58
+ arch: process.arch,
59
+ nodeVersion: process.version,
60
+ uptime: os.uptime(),
61
+ cpus: os.cpus().length,
62
+ totalMemory: os.totalmem(),
63
+ freeMemory: os.freemem(),
64
+ hostname: os.hostname(),
65
+ userInfo: os.userInfo(),
66
+ };
67
+ }
68
+ export function registerTerminalTools(server, registry) {
69
+ server.registerTool('shell_exec', {
70
+ description: 'Execute shell command',
71
+ inputSchema: ShellExecSchema,
72
+ }, async (params) => ({
73
+ content: [{ type: 'text', text: JSON.stringify(await shellExec(params), null, 2) }],
74
+ }));
75
+ server.tool('process_list', 'List running processes', {}, async () => ({
76
+ content: [{ type: 'text', text: JSON.stringify(await processList(), null, 2) }],
77
+ }));
78
+ server.tool('system_info', 'Get system information', {}, async () => ({
79
+ content: [{ type: 'text', text: JSON.stringify(await systemInfo(), null, 2) }],
80
+ }));
81
+ registry.register({ name: 'shell_exec', category: 'terminal', description: 'Execute shell command', handler: shellExec });
82
+ registry.register({ name: 'process_list', category: 'terminal', description: 'List processes', handler: processList });
83
+ registry.register({ name: 'system_info', category: 'terminal', description: 'System info', handler: systemInfo });
84
+ log.info('Registered 3 terminal tools');
85
+ }
86
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/terminal/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import { ToolRegistry } from '../../core/registry.js';
3
+ export declare function registerWebTools(server: McpServer, registry: ToolRegistry): void;
4
+ //# sourceMappingURL=index.d.ts.map