hippocampus-mcp 1.0.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.
- package/README.md +284 -0
- package/dist/aws/credentials-provider.d.ts +20 -0
- package/dist/aws/credentials-provider.d.ts.map +1 -0
- package/dist/aws/credentials-provider.js +107 -0
- package/dist/aws/credentials-provider.js.map +1 -0
- package/dist/config/environment.d.ts +12 -0
- package/dist/config/environment.d.ts.map +1 -0
- package/dist/config/environment.js +42 -0
- package/dist/config/environment.js.map +1 -0
- package/dist/config/index.d.ts +2 -0
- package/dist/config/index.d.ts.map +1 -0
- package/dist/config/index.js +2 -0
- package/dist/config/index.js.map +1 -0
- package/dist/data/dynamodb-client.d.ts +25 -0
- package/dist/data/dynamodb-client.d.ts.map +1 -0
- package/dist/data/dynamodb-client.js +107 -0
- package/dist/data/dynamodb-client.js.map +1 -0
- package/dist/data/entity-manager.d.ts +31 -0
- package/dist/data/entity-manager.d.ts.map +1 -0
- package/dist/data/entity-manager.js +330 -0
- package/dist/data/entity-manager.js.map +1 -0
- package/dist/data/models.d.ts +67 -0
- package/dist/data/models.d.ts.map +1 -0
- package/dist/data/models.js +19 -0
- package/dist/data/models.js.map +1 -0
- package/dist/data/preference-manager.d.ts +11 -0
- package/dist/data/preference-manager.d.ts.map +1 -0
- package/dist/data/preference-manager.js +47 -0
- package/dist/data/preference-manager.js.map +1 -0
- package/dist/data/search-engine.d.ts +19 -0
- package/dist/data/search-engine.d.ts.map +1 -0
- package/dist/data/search-engine.js +164 -0
- package/dist/data/search-engine.js.map +1 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +105 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp/resource-registry.d.ts +18 -0
- package/dist/mcp/resource-registry.d.ts.map +1 -0
- package/dist/mcp/resource-registry.js +140 -0
- package/dist/mcp/resource-registry.js.map +1 -0
- package/dist/mcp/tool-handler.d.ts +37 -0
- package/dist/mcp/tool-handler.d.ts.map +1 -0
- package/dist/mcp/tool-handler.js +221 -0
- package/dist/mcp/tool-handler.js.map +1 -0
- package/dist/mcp/tool-registry.d.ts +6 -0
- package/dist/mcp/tool-registry.d.ts.map +1 -0
- package/dist/mcp/tool-registry.js +619 -0
- package/dist/mcp/tool-registry.js.map +1 -0
- package/dist/protocol/jsonrpc-handler.d.ts +36 -0
- package/dist/protocol/jsonrpc-handler.d.ts.map +1 -0
- package/dist/protocol/jsonrpc-handler.js +143 -0
- package/dist/protocol/jsonrpc-handler.js.map +1 -0
- package/dist/protocol/stdio-handler.d.ts +20 -0
- package/dist/protocol/stdio-handler.d.ts.map +1 -0
- package/dist/protocol/stdio-handler.js +100 -0
- package/dist/protocol/stdio-handler.js.map +1 -0
- package/dist/protocol/types.d.ts +38 -0
- package/dist/protocol/types.d.ts.map +1 -0
- package/dist/protocol/types.js +11 -0
- package/dist/protocol/types.js.map +1 -0
- package/dist/utils/errors.d.ts +2 -0
- package/dist/utils/errors.d.ts.map +1 -0
- package/dist/utils/errors.js +2 -0
- package/dist/utils/errors.js.map +1 -0
- package/dist/utils/logger.d.ts +2 -0
- package/dist/utils/logger.d.ts.map +1 -0
- package/dist/utils/logger.js +2 -0
- package/dist/utils/logger.js.map +1 -0
- package/package.json +81 -0
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
import { MCPProtocolError } from './types';
|
|
2
|
+
export class JSONRPCHandler {
|
|
3
|
+
handlers = new Map();
|
|
4
|
+
serverInfo;
|
|
5
|
+
capabilities;
|
|
6
|
+
toolRegistry = [];
|
|
7
|
+
resourceRegistry = [];
|
|
8
|
+
toolExecutor;
|
|
9
|
+
resourceReader;
|
|
10
|
+
constructor(serverInfo, capabilities) {
|
|
11
|
+
this.serverInfo = serverInfo;
|
|
12
|
+
this.capabilities = capabilities;
|
|
13
|
+
this.registerBuiltInMethods();
|
|
14
|
+
}
|
|
15
|
+
registerBuiltInMethods() {
|
|
16
|
+
this.registerMethod('initialize', async (params) => {
|
|
17
|
+
return {
|
|
18
|
+
protocolVersion: '2024-11-05',
|
|
19
|
+
serverInfo: this.serverInfo,
|
|
20
|
+
capabilities: this.capabilities,
|
|
21
|
+
};
|
|
22
|
+
});
|
|
23
|
+
this.registerMethod('tools/list', async (params) => {
|
|
24
|
+
return {
|
|
25
|
+
tools: this.toolRegistry,
|
|
26
|
+
};
|
|
27
|
+
});
|
|
28
|
+
this.registerMethod('resources/list', async (params) => {
|
|
29
|
+
return {
|
|
30
|
+
resources: this.resourceRegistry,
|
|
31
|
+
};
|
|
32
|
+
});
|
|
33
|
+
this.registerMethod('tools/call', async (params) => {
|
|
34
|
+
if (!params || typeof params.name !== 'string') {
|
|
35
|
+
throw new MCPProtocolError(-32602, 'Invalid params: tools/call requires a "name" parameter');
|
|
36
|
+
}
|
|
37
|
+
if (!this.toolExecutor) {
|
|
38
|
+
throw new MCPProtocolError(-32603, 'Internal error: tool executor not configured');
|
|
39
|
+
}
|
|
40
|
+
const toolParams = params.arguments || {};
|
|
41
|
+
const result = await this.toolExecutor(params.name, toolParams);
|
|
42
|
+
return {
|
|
43
|
+
content: [
|
|
44
|
+
{
|
|
45
|
+
type: 'text',
|
|
46
|
+
text: JSON.stringify(result, null, 2),
|
|
47
|
+
},
|
|
48
|
+
],
|
|
49
|
+
};
|
|
50
|
+
});
|
|
51
|
+
this.registerMethod('resources/read', async (params) => {
|
|
52
|
+
if (!params || typeof params.uri !== 'string') {
|
|
53
|
+
throw new MCPProtocolError(-32602, 'Invalid params: resources/read requires a "uri" parameter');
|
|
54
|
+
}
|
|
55
|
+
if (!this.resourceReader) {
|
|
56
|
+
throw new MCPProtocolError(-32603, 'Internal error: resource reader not configured');
|
|
57
|
+
}
|
|
58
|
+
try {
|
|
59
|
+
const content = await this.resourceReader(params.uri);
|
|
60
|
+
return {
|
|
61
|
+
contents: [
|
|
62
|
+
{
|
|
63
|
+
uri: params.uri,
|
|
64
|
+
mimeType: 'application/json',
|
|
65
|
+
text: content,
|
|
66
|
+
},
|
|
67
|
+
],
|
|
68
|
+
};
|
|
69
|
+
}
|
|
70
|
+
catch (error) {
|
|
71
|
+
throw new MCPProtocolError(-32603, `Failed to read resource: ${error instanceof Error ? error.message : String(error)}`);
|
|
72
|
+
}
|
|
73
|
+
});
|
|
74
|
+
}
|
|
75
|
+
setToolRegistry(tools) {
|
|
76
|
+
this.toolRegistry = tools;
|
|
77
|
+
}
|
|
78
|
+
setResourceRegistry(resources) {
|
|
79
|
+
this.resourceRegistry = resources;
|
|
80
|
+
}
|
|
81
|
+
setToolExecutor(executor) {
|
|
82
|
+
this.toolExecutor = executor;
|
|
83
|
+
}
|
|
84
|
+
setResourceReader(reader) {
|
|
85
|
+
this.resourceReader = reader;
|
|
86
|
+
}
|
|
87
|
+
registerMethod(method, handler) {
|
|
88
|
+
this.handlers.set(method, handler);
|
|
89
|
+
}
|
|
90
|
+
async handleRequest(request) {
|
|
91
|
+
if (request.jsonrpc !== '2.0') {
|
|
92
|
+
return this.createErrorResponse(request.id, -32600, 'Invalid Request: jsonrpc must be "2.0"');
|
|
93
|
+
}
|
|
94
|
+
if (typeof request.method !== 'string' || request.method.length === 0) {
|
|
95
|
+
return this.createErrorResponse(request.id, -32600, 'Invalid Request: method must be a non-empty string');
|
|
96
|
+
}
|
|
97
|
+
const handler = this.handlers.get(request.method);
|
|
98
|
+
if (!handler) {
|
|
99
|
+
return this.createErrorResponse(request.id, -32601, `Method not found: ${request.method}`);
|
|
100
|
+
}
|
|
101
|
+
try {
|
|
102
|
+
const result = await handler(request.params);
|
|
103
|
+
return this.createSuccessResponse(request.id, result);
|
|
104
|
+
}
|
|
105
|
+
catch (error) {
|
|
106
|
+
if (error instanceof MCPProtocolError) {
|
|
107
|
+
return this.createErrorResponse(request.id, error.code, error.message, error.data);
|
|
108
|
+
}
|
|
109
|
+
return this.createErrorResponse(request.id, -32603, `Internal error: ${error instanceof Error ? error.message : String(error)}`);
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
createSuccessResponse(id, result) {
|
|
113
|
+
return {
|
|
114
|
+
jsonrpc: '2.0',
|
|
115
|
+
id: id ?? null,
|
|
116
|
+
result,
|
|
117
|
+
};
|
|
118
|
+
}
|
|
119
|
+
createErrorResponse(id, code, message, data) {
|
|
120
|
+
return {
|
|
121
|
+
jsonrpc: '2.0',
|
|
122
|
+
id: id ?? null,
|
|
123
|
+
error: {
|
|
124
|
+
code,
|
|
125
|
+
message,
|
|
126
|
+
data,
|
|
127
|
+
},
|
|
128
|
+
};
|
|
129
|
+
}
|
|
130
|
+
getRegisteredMethods() {
|
|
131
|
+
return Array.from(this.handlers.keys());
|
|
132
|
+
}
|
|
133
|
+
hasMethod(method) {
|
|
134
|
+
return this.handlers.has(method);
|
|
135
|
+
}
|
|
136
|
+
unregisterMethod(method) {
|
|
137
|
+
return this.handlers.delete(method);
|
|
138
|
+
}
|
|
139
|
+
clearHandlers() {
|
|
140
|
+
this.handlers.clear();
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
//# sourceMappingURL=jsonrpc-handler.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"jsonrpc-handler.js","sourceRoot":"","sources":["../../src/protocol/jsonrpc-handler.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { Readable, Writable } from 'stream';
|
|
2
|
+
import { MCPRequest, MCPResponse } from './types';
|
|
3
|
+
export type MessageHandler = (message: MCPRequest) => Promise<MCPResponse>;
|
|
4
|
+
export declare class StdioHandler {
|
|
5
|
+
private buffer;
|
|
6
|
+
private messageHandler;
|
|
7
|
+
private isRunning;
|
|
8
|
+
private readonly input;
|
|
9
|
+
private readonly output;
|
|
10
|
+
constructor(input?: Readable, output?: Writable);
|
|
11
|
+
setMessageHandler(handler: MessageHandler): void;
|
|
12
|
+
start(): void;
|
|
13
|
+
stop(): void;
|
|
14
|
+
private handleData;
|
|
15
|
+
private processMessage;
|
|
16
|
+
writeResponse(response: MCPResponse): void;
|
|
17
|
+
private writeError;
|
|
18
|
+
isActive(): boolean;
|
|
19
|
+
}
|
|
20
|
+
//# sourceMappingURL=stdio-handler.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"stdio-handler.d.ts","sourceRoot":"","sources":["../../src/protocol/stdio-handler.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAKlD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAQ3E,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;gBAOtB,KAAK,GAAE,QAAwB,EAAE,MAAM,GAAE,QAAyB;IAQ9E,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAOhD,KAAK,IAAI,IAAI;IAqCb,IAAI,IAAI,IAAI;IAaZ,OAAO,CAAC,UAAU;YAwBJ,cAAc;IA2C5B,aAAa,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAQ1C,OAAO,CAAC,UAAU;IAqBlB,QAAQ,IAAI,OAAO;CAGpB"}
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
export class StdioHandler {
|
|
2
|
+
buffer = '';
|
|
3
|
+
messageHandler = null;
|
|
4
|
+
isRunning = false;
|
|
5
|
+
input;
|
|
6
|
+
output;
|
|
7
|
+
constructor(input = process.stdin, output = process.stdout) {
|
|
8
|
+
this.input = input;
|
|
9
|
+
this.output = output;
|
|
10
|
+
}
|
|
11
|
+
setMessageHandler(handler) {
|
|
12
|
+
this.messageHandler = handler;
|
|
13
|
+
}
|
|
14
|
+
start() {
|
|
15
|
+
if (this.isRunning) {
|
|
16
|
+
return;
|
|
17
|
+
}
|
|
18
|
+
this.isRunning = true;
|
|
19
|
+
this.input.setEncoding('utf8');
|
|
20
|
+
this.input.on('data', (chunk) => {
|
|
21
|
+
this.handleData(chunk);
|
|
22
|
+
});
|
|
23
|
+
this.input.on('end', () => {
|
|
24
|
+
this.stop();
|
|
25
|
+
});
|
|
26
|
+
if (this.input === process.stdin) {
|
|
27
|
+
process.on('SIGINT', () => {
|
|
28
|
+
this.stop();
|
|
29
|
+
process.exit(0);
|
|
30
|
+
});
|
|
31
|
+
process.on('SIGTERM', () => {
|
|
32
|
+
this.stop();
|
|
33
|
+
process.exit(0);
|
|
34
|
+
});
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
stop() {
|
|
38
|
+
if (!this.isRunning) {
|
|
39
|
+
return;
|
|
40
|
+
}
|
|
41
|
+
this.isRunning = false;
|
|
42
|
+
this.input.pause();
|
|
43
|
+
}
|
|
44
|
+
handleData(chunk) {
|
|
45
|
+
this.buffer += chunk;
|
|
46
|
+
let newlineIndex;
|
|
47
|
+
while ((newlineIndex = this.buffer.indexOf('\n')) !== -1) {
|
|
48
|
+
const line = this.buffer.slice(0, newlineIndex).trim();
|
|
49
|
+
this.buffer = this.buffer.slice(newlineIndex + 1);
|
|
50
|
+
if (line.length === 0) {
|
|
51
|
+
continue;
|
|
52
|
+
}
|
|
53
|
+
this.processMessage(line);
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
async processMessage(line) {
|
|
57
|
+
try {
|
|
58
|
+
const message = JSON.parse(line);
|
|
59
|
+
if (message.jsonrpc !== '2.0' || typeof message.method !== 'string') {
|
|
60
|
+
this.writeError(message.id, -32600, 'Invalid Request: missing or invalid jsonrpc or method field');
|
|
61
|
+
return;
|
|
62
|
+
}
|
|
63
|
+
if (this.messageHandler) {
|
|
64
|
+
const response = await this.messageHandler(message);
|
|
65
|
+
this.writeResponse(response);
|
|
66
|
+
}
|
|
67
|
+
else {
|
|
68
|
+
this.writeError(message.id, -32603, 'Internal error: no message handler configured');
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
catch (error) {
|
|
72
|
+
if (error instanceof SyntaxError) {
|
|
73
|
+
this.writeError(undefined, -32700, 'Parse error: invalid JSON');
|
|
74
|
+
}
|
|
75
|
+
else {
|
|
76
|
+
this.writeError(undefined, -32603, `Internal error: ${error instanceof Error ? error.message : String(error)}`);
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
writeResponse(response) {
|
|
81
|
+
const json = JSON.stringify(response);
|
|
82
|
+
this.output.write(json + '\n');
|
|
83
|
+
}
|
|
84
|
+
writeError(id, code, message, data) {
|
|
85
|
+
const response = {
|
|
86
|
+
jsonrpc: '2.0',
|
|
87
|
+
id: id ?? null,
|
|
88
|
+
error: {
|
|
89
|
+
code,
|
|
90
|
+
message,
|
|
91
|
+
data,
|
|
92
|
+
},
|
|
93
|
+
};
|
|
94
|
+
this.writeResponse(response);
|
|
95
|
+
}
|
|
96
|
+
isActive() {
|
|
97
|
+
return this.isRunning;
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
//# sourceMappingURL=stdio-handler.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"stdio-handler.js","sourceRoot":"","sources":["../../src/protocol/stdio-handler.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
export interface MCPRequest {
|
|
2
|
+
jsonrpc: "2.0";
|
|
3
|
+
id?: string | number;
|
|
4
|
+
method: string;
|
|
5
|
+
params?: Record<string, any>;
|
|
6
|
+
}
|
|
7
|
+
export interface MCPResponse {
|
|
8
|
+
jsonrpc: "2.0";
|
|
9
|
+
id: string | number;
|
|
10
|
+
result?: any;
|
|
11
|
+
error?: MCPError;
|
|
12
|
+
}
|
|
13
|
+
export interface MCPError {
|
|
14
|
+
code: number;
|
|
15
|
+
message: string;
|
|
16
|
+
data?: any;
|
|
17
|
+
}
|
|
18
|
+
export declare class MCPProtocolError extends Error {
|
|
19
|
+
code: number;
|
|
20
|
+
data?: any | undefined;
|
|
21
|
+
constructor(code: number, message: string, data?: any | undefined);
|
|
22
|
+
}
|
|
23
|
+
export interface MCPTool {
|
|
24
|
+
name: string;
|
|
25
|
+
description: string;
|
|
26
|
+
inputSchema: {
|
|
27
|
+
type: "object";
|
|
28
|
+
properties: Record<string, any>;
|
|
29
|
+
required?: string[];
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
export interface MCPResource {
|
|
33
|
+
uri: string;
|
|
34
|
+
name: string;
|
|
35
|
+
description: string;
|
|
36
|
+
mimeType: string;
|
|
37
|
+
}
|
|
38
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/protocol/types.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAKD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAKD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAKD,qBAAa,gBAAiB,SAAQ,KAAK;IAEhC,IAAI,EAAE,MAAM;IAEZ,IAAI,CAAC,EAAE,GAAG;gBAFV,IAAI,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACR,IAAI,CAAC,EAAE,GAAG,YAAA;CAKpB;AAKD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAKD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/protocol/types.ts"],"names":[],"mappings":"AAuCA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAEhC;IAEA;IAHT,YACS,IAAY,EACnB,OAAe,EACR,IAAU;QAEjB,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAQ;QAEZ,SAAI,GAAJ,IAAI,CAAM;QAGjB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":""}
|
package/package.json
ADDED
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "hippocampus-mcp",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "Personal Knowledge MCP Server - Provides AI assistants with access to personal knowledge, preferences, and contextual information stored in AWS DynamoDB",
|
|
5
|
+
"main": "dist/index.js",
|
|
6
|
+
"type": "module",
|
|
7
|
+
"bin": {
|
|
8
|
+
"hippocampus-mcp": "./dist/index.js"
|
|
9
|
+
},
|
|
10
|
+
"scripts": {
|
|
11
|
+
"build": "tsc",
|
|
12
|
+
"build:watch": "tsc --watch",
|
|
13
|
+
"start": "node dist/index.js",
|
|
14
|
+
"dev": "tsc && node dist/index.js",
|
|
15
|
+
"test": "jest",
|
|
16
|
+
"test:watch": "jest --watch",
|
|
17
|
+
"test:coverage": "jest --coverage",
|
|
18
|
+
"clean": "rm -rf dist",
|
|
19
|
+
"lint": "eslint src --ext .ts",
|
|
20
|
+
"lint:fix": "eslint src --ext .ts --fix",
|
|
21
|
+
"prepublishOnly": "npm run clean && npm run build",
|
|
22
|
+
"deploy": "tsx bin/deploy.ts",
|
|
23
|
+
"cdk": "cdk",
|
|
24
|
+
"cdk:deploy": "cdk deploy --profile hc1 --require-approval never",
|
|
25
|
+
"cdk:synth": "cdk synth --profile hc1",
|
|
26
|
+
"cdk:diff": "cdk diff --profile hc1",
|
|
27
|
+
"cdk:destroy": "cdk destroy --profile hc1"
|
|
28
|
+
},
|
|
29
|
+
"keywords": [
|
|
30
|
+
"mcp",
|
|
31
|
+
"model-context-protocol",
|
|
32
|
+
"personal-knowledge",
|
|
33
|
+
"aws",
|
|
34
|
+
"dynamodb",
|
|
35
|
+
"ai-assistant",
|
|
36
|
+
"bedrock",
|
|
37
|
+
"knowledge-base"
|
|
38
|
+
],
|
|
39
|
+
"author": "hippocampus_v1",
|
|
40
|
+
"license": "MIT",
|
|
41
|
+
"repository": {
|
|
42
|
+
"type": "git",
|
|
43
|
+
"url": "https://github.com/yourusername/hippocampus-mcp.git"
|
|
44
|
+
},
|
|
45
|
+
"bugs": {
|
|
46
|
+
"url": "https://github.com/yourusername/hippocampus-mcp/issues"
|
|
47
|
+
},
|
|
48
|
+
"homepage": "https://github.com/yourusername/hippocampus-mcp#readme",
|
|
49
|
+
"files": [
|
|
50
|
+
"dist/**/*",
|
|
51
|
+
"README.md",
|
|
52
|
+
"LICENSE"
|
|
53
|
+
],
|
|
54
|
+
"dependencies": {
|
|
55
|
+
"@aws-sdk/client-dynamodb": "^3.709.0",
|
|
56
|
+
"@aws-sdk/lib-dynamodb": "^3.709.0",
|
|
57
|
+
"uuid": "^11.0.3"
|
|
58
|
+
},
|
|
59
|
+
"devDependencies": {
|
|
60
|
+
"@types/jest": "^29.5.14",
|
|
61
|
+
"@types/node": "^22.10.2",
|
|
62
|
+
"@types/source-map-support": "^0.5.10",
|
|
63
|
+
"@types/uuid": "^10.0.0",
|
|
64
|
+
"@typescript-eslint/eslint-plugin": "^8.18.2",
|
|
65
|
+
"@typescript-eslint/parser": "^8.18.2",
|
|
66
|
+
"aws-cdk": "^2.1101.0",
|
|
67
|
+
"aws-cdk-lib": "^2.235.1",
|
|
68
|
+
"constructs": "^10.4.5",
|
|
69
|
+
"eslint": "^9.17.0",
|
|
70
|
+
"fast-check": "^3.23.1",
|
|
71
|
+
"jest": "^29.7.0",
|
|
72
|
+
"source-map-support": "^0.5.21",
|
|
73
|
+
"ts-jest": "^29.2.5",
|
|
74
|
+
"ts-node": "^10.9.2",
|
|
75
|
+
"tsx": "^4.21.0",
|
|
76
|
+
"typescript": "^5.7.2"
|
|
77
|
+
},
|
|
78
|
+
"engines": {
|
|
79
|
+
"node": ">=18.0.0"
|
|
80
|
+
}
|
|
81
|
+
}
|