@lhremote/mcp 0.5.0 → 0.7.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 +6 -5
- package/dist/server.test.js +11 -1
- package/dist/server.test.js.map +1 -1
- package/dist/tools/add-people-to-collection.d.ts +4 -0
- package/dist/tools/add-people-to-collection.d.ts.map +1 -0
- package/dist/tools/add-people-to-collection.js +29 -0
- package/dist/tools/add-people-to-collection.js.map +1 -0
- package/dist/tools/build-linkedin-url.d.ts +4 -0
- package/dist/tools/build-linkedin-url.d.ts.map +1 -0
- package/dist/tools/build-linkedin-url.js +117 -0
- package/dist/tools/build-linkedin-url.js.map +1 -0
- package/dist/tools/build-linkedin-url.test.d.ts +2 -0
- package/dist/tools/build-linkedin-url.test.d.ts.map +1 -0
- package/dist/tools/build-linkedin-url.test.js +101 -0
- package/dist/tools/build-linkedin-url.test.js.map +1 -0
- package/dist/tools/collect-people.d.ts +4 -0
- package/dist/tools/collect-people.d.ts.map +1 -0
- package/dist/tools/collect-people.js +67 -0
- package/dist/tools/collect-people.js.map +1 -0
- package/dist/tools/collect-people.test.d.ts +2 -0
- package/dist/tools/collect-people.test.d.ts.map +1 -0
- package/dist/tools/collect-people.test.js +129 -0
- package/dist/tools/collect-people.test.js.map +1 -0
- package/dist/tools/create-collection.d.ts +4 -0
- package/dist/tools/create-collection.d.ts.map +1 -0
- package/dist/tools/create-collection.js +24 -0
- package/dist/tools/create-collection.js.map +1 -0
- package/dist/tools/delete-collection.d.ts +4 -0
- package/dist/tools/delete-collection.d.ts.map +1 -0
- package/dist/tools/delete-collection.js +25 -0
- package/dist/tools/delete-collection.js.map +1 -0
- package/dist/tools/import-people-from-collection.d.ts +4 -0
- package/dist/tools/import-people-from-collection.d.ts.map +1 -0
- package/dist/tools/import-people-from-collection.js +33 -0
- package/dist/tools/import-people-from-collection.js.map +1 -0
- package/dist/tools/index.d.ts +11 -1
- package/dist/tools/index.d.ts.map +1 -1
- package/dist/tools/index.js +21 -1
- package/dist/tools/index.js.map +1 -1
- package/dist/tools/list-collections.d.ts +4 -0
- package/dist/tools/list-collections.d.ts.map +1 -0
- package/dist/tools/list-collections.js +19 -0
- package/dist/tools/list-collections.js.map +1 -0
- package/dist/tools/list-linkedin-reference-data.d.ts +4 -0
- package/dist/tools/list-linkedin-reference-data.d.ts.map +1 -0
- package/dist/tools/list-linkedin-reference-data.js +24 -0
- package/dist/tools/list-linkedin-reference-data.js.map +1 -0
- package/dist/tools/list-linkedin-reference-data.test.d.ts +2 -0
- package/dist/tools/list-linkedin-reference-data.test.d.ts.map +1 -0
- package/dist/tools/list-linkedin-reference-data.test.js +48 -0
- package/dist/tools/list-linkedin-reference-data.test.js.map +1 -0
- package/dist/tools/remove-people-from-collection.d.ts +4 -0
- package/dist/tools/remove-people-from-collection.d.ts.map +1 -0
- package/dist/tools/remove-people-from-collection.js +29 -0
- package/dist/tools/remove-people-from-collection.js.map +1 -0
- package/dist/tools/resolve-linkedin-entity.d.ts +4 -0
- package/dist/tools/resolve-linkedin-entity.d.ts.map +1 -0
- package/dist/tools/resolve-linkedin-entity.js +30 -0
- package/dist/tools/resolve-linkedin-entity.js.map +1 -0
- package/dist/tools/resolve-linkedin-entity.test.d.ts +2 -0
- package/dist/tools/resolve-linkedin-entity.test.d.ts.map +1 -0
- package/dist/tools/resolve-linkedin-entity.test.js +66 -0
- package/dist/tools/resolve-linkedin-entity.test.js.map +1 -0
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
MCP server for [lhremote](https://github.com/alexey-pelykh/lhremote) — LinkedHelper automation toolkit.
|
|
4
4
|
|
|
5
|
-
This package exposes the full LinkedHelper automation surface as a [Model Context Protocol](https://modelcontextprotocol.io) server. AI assistants (Claude, etc.) connect over stdio and use the
|
|
5
|
+
This package exposes the full LinkedHelper automation surface as a [Model Context Protocol](https://modelcontextprotocol.io) server. AI assistants (Claude, etc.) connect over stdio and use the 44 registered tools to control LinkedHelper.
|
|
6
6
|
|
|
7
7
|
Built on [`@lhremote/core`](../core).
|
|
8
8
|
|
|
@@ -52,10 +52,11 @@ await runStdioServer();
|
|
|
52
52
|
| Account & Instance | `list-accounts`, `start-instance`, `stop-instance`, `check-status` |
|
|
53
53
|
| Campaigns | `campaign-list`, `campaign-create`, `campaign-get`, `campaign-export`, `campaign-update`, `campaign-delete`, `campaign-start`, `campaign-stop` |
|
|
54
54
|
| Campaign Status | `campaign-status`, `campaign-statistics`, `campaign-retry` |
|
|
55
|
-
| Campaign Actions | `campaign-add-action`, `campaign-remove-action`, `campaign-reorder-actions`, `campaign-move-next` |
|
|
56
|
-
| Campaign Targeting | `campaign-exclude-list`, `campaign-exclude-add`, `campaign-exclude-remove`, `import-people-from-urls` |
|
|
57
|
-
|
|
|
58
|
-
|
|
|
55
|
+
| Campaign Actions | `campaign-add-action`, `campaign-remove-action`, `campaign-update-action`, `campaign-reorder-actions`, `campaign-move-next` |
|
|
56
|
+
| Campaign Targeting | `campaign-exclude-list`, `campaign-exclude-add`, `campaign-exclude-remove`, `campaign-list-people`, `campaign-remove-people`, `import-people-from-urls`, `collect-people` |
|
|
57
|
+
| Collections | `list-collections`, `create-collection`, `delete-collection`, `add-people-to-collection`, `remove-people-from-collection`, `import-people-from-collection` |
|
|
58
|
+
| Profiles & Messaging | `query-profile`, `query-profiles`, `query-profiles-bulk`, `query-messages`, `check-replies`, `scrape-messaging-history` |
|
|
59
|
+
| Utilities | `describe-actions`, `get-errors` |
|
|
59
60
|
|
|
60
61
|
See the [root README](https://github.com/alexey-pelykh/lhremote#mcp-tools) for parameter details on each tool.
|
|
61
62
|
|
package/dist/server.test.js
CHANGED
|
@@ -83,7 +83,17 @@ describe("createServer", () => {
|
|
|
83
83
|
expect(names).toContain("campaign-update-action");
|
|
84
84
|
expect(names).toContain("campaign-remove-people");
|
|
85
85
|
expect(names).toContain("get-errors");
|
|
86
|
-
expect(names).
|
|
86
|
+
expect(names).toContain("list-collections");
|
|
87
|
+
expect(names).toContain("create-collection");
|
|
88
|
+
expect(names).toContain("delete-collection");
|
|
89
|
+
expect(names).toContain("add-people-to-collection");
|
|
90
|
+
expect(names).toContain("remove-people-from-collection");
|
|
91
|
+
expect(names).toContain("import-people-from-collection");
|
|
92
|
+
expect(names).toContain("collect-people");
|
|
93
|
+
expect(names).toContain("build-linkedin-url");
|
|
94
|
+
expect(names).toContain("list-linkedin-reference-data");
|
|
95
|
+
expect(names).toContain("resolve-linkedin-entity");
|
|
96
|
+
expect(names).toHaveLength(47);
|
|
87
97
|
});
|
|
88
98
|
});
|
|
89
99
|
//# sourceMappingURL=server.test.js.map
|
package/dist/server.test.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.test.js","sourceRoot":"","sources":["../src/server.test.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"server.test.js","sourceRoot":"","sources":["../src/server.test.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
/** Register the {@link https://github.com/alexey-pelykh/lhremote#add-people-to-collection | add-people-to-collection} MCP tool. */
|
|
3
|
+
export declare function registerAddPeopleToCollection(server: McpServer): void;
|
|
4
|
+
//# sourceMappingURL=add-people-to-collection.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"add-people-to-collection.d.ts","sourceRoot":"","sources":["../../src/tools/add-people-to-collection.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,mIAAmI;AACnI,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyBrE"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
// SPDX-License-Identifier: AGPL-3.0-only
|
|
2
|
+
// Copyright (C) 2026 Oleksii PELYKH
|
|
3
|
+
import { addPeopleToCollection } from "@lhremote/core";
|
|
4
|
+
import { z } from "zod";
|
|
5
|
+
import { cdpConnectionSchema, mcpCatchAll, mcpSuccess } from "../helpers.js";
|
|
6
|
+
/** Register the {@link https://github.com/alexey-pelykh/lhremote#add-people-to-collection | add-people-to-collection} MCP tool. */
|
|
7
|
+
export function registerAddPeopleToCollection(server) {
|
|
8
|
+
server.tool("add-people-to-collection", "Add people to a LinkedHelper collection (List) by person IDs. Idempotent — adding an already-present person is a no-op.", {
|
|
9
|
+
collectionId: z
|
|
10
|
+
.number()
|
|
11
|
+
.int()
|
|
12
|
+
.positive()
|
|
13
|
+
.describe("Collection ID to add people to"),
|
|
14
|
+
personIds: z
|
|
15
|
+
.array(z.number().int().positive())
|
|
16
|
+
.nonempty()
|
|
17
|
+
.describe("Person IDs to add to the collection"),
|
|
18
|
+
...cdpConnectionSchema,
|
|
19
|
+
}, async ({ collectionId, personIds, cdpPort, cdpHost, allowRemote }) => {
|
|
20
|
+
try {
|
|
21
|
+
const result = await addPeopleToCollection({ collectionId, personIds, cdpPort, cdpHost, allowRemote });
|
|
22
|
+
return mcpSuccess(JSON.stringify(result, null, 2));
|
|
23
|
+
}
|
|
24
|
+
catch (error) {
|
|
25
|
+
return mcpCatchAll(error, "Failed to add people to collection");
|
|
26
|
+
}
|
|
27
|
+
});
|
|
28
|
+
}
|
|
29
|
+
//# sourceMappingURL=add-people-to-collection.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"add-people-to-collection.js","sourceRoot":"","sources":["../../src/tools/add-people-to-collection.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE7E,mIAAmI;AACnI,MAAM,UAAU,6BAA6B,CAAC,MAAiB;IAC7D,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,yHAAyH,EACzH;QACE,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,CAAC,gCAAgC,CAAC;QAC7C,SAAS,EAAE,CAAC;aACT,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;aAClC,QAAQ,EAAE;aACV,QAAQ,CAAC,qCAAqC,CAAC;QAClD,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QACnE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YACvG,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,EAAE,oCAAoC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
/** Register the {@link https://github.com/alexey-pelykh/lhremote#build-linkedin-url | build-linkedin-url} MCP tool. */
|
|
3
|
+
export declare function registerBuildLinkedInUrl(server: McpServer): void;
|
|
4
|
+
//# sourceMappingURL=build-linkedin-url.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"build-linkedin-url.d.ts","sourceRoot":"","sources":["../../src/tools/build-linkedin-url.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqCzE,uHAAuH;AACvH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8FhE"}
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
// SPDX-License-Identifier: AGPL-3.0-only
|
|
2
|
+
// Copyright (C) 2026 Oleksii PELYKH
|
|
3
|
+
import { buildLinkedInUrl } from "@lhremote/core";
|
|
4
|
+
import { z } from "zod";
|
|
5
|
+
import { mcpError, mcpSuccess } from "../helpers.js";
|
|
6
|
+
const snFilterValueSchema = z.object({
|
|
7
|
+
id: z.string().describe("Entity ID or URN"),
|
|
8
|
+
text: z.string().optional().describe("Display text"),
|
|
9
|
+
selectionType: z
|
|
10
|
+
.enum(["INCLUDED", "EXCLUDED"])
|
|
11
|
+
.describe("Include or exclude this value"),
|
|
12
|
+
});
|
|
13
|
+
const snFilterSchema = z.object({
|
|
14
|
+
type: z
|
|
15
|
+
.string()
|
|
16
|
+
.describe("Filter type (CURRENT_COMPANY, PAST_COMPANY, REGION, SENIORITY_LEVEL, FUNCTION, INDUSTRY, COMPANY_HEADCOUNT, COMPANY_TYPE, CURRENT_TITLE, PAST_TITLE, YEARS_AT_CURRENT_COMPANY, YEARS_AT_CURRENT_POSITION, YEARS_OF_EXPERIENCE, SCHOOL, PROFILE_LANGUAGE, GROUP, CONNECTION)"),
|
|
17
|
+
values: z.array(snFilterValueSchema).describe("Filter values"),
|
|
18
|
+
});
|
|
19
|
+
const booleanExpressionSchema = z.union([
|
|
20
|
+
z.object({
|
|
21
|
+
raw: z.string().describe("Raw boolean expression string"),
|
|
22
|
+
}).strict(),
|
|
23
|
+
z.object({
|
|
24
|
+
and: z.array(z.string()).optional().describe("Terms joined with AND"),
|
|
25
|
+
or: z.array(z.string()).optional().describe("Terms grouped with OR"),
|
|
26
|
+
not: z.array(z.string()).optional().describe("Terms negated with NOT"),
|
|
27
|
+
phrases: z
|
|
28
|
+
.array(z.string())
|
|
29
|
+
.optional()
|
|
30
|
+
.describe("Exact phrases (quoted)"),
|
|
31
|
+
}),
|
|
32
|
+
]);
|
|
33
|
+
/** Register the {@link https://github.com/alexey-pelykh/lhremote#build-linkedin-url | build-linkedin-url} MCP tool. */
|
|
34
|
+
export function registerBuildLinkedInUrl(server) {
|
|
35
|
+
server.tool("build-linkedin-url", "Build a LinkedIn URL for any supported source type. Dispatches to the appropriate builder based on sourceType: SearchPage (basic search with faceted filters), SNSearchPage (Sales Navigator with Rest.li encoding), parameterised templates (company/school/group/event pages), or fixed URLs (connections, profile views, etc.).", {
|
|
36
|
+
sourceType: z
|
|
37
|
+
.string()
|
|
38
|
+
.describe("LinkedIn source type (SearchPage, SNSearchPage, OrganizationPeople, Alumni, Group, Event, MyConnections, LWVYPP, SentInvitationPage, FollowersPage, FollowingPage, SNListPage, SNOrgsPage, SNOrgsListsPage, TSearchPage, TProjectPage, RSearchPage, RProjectPage)"),
|
|
39
|
+
// SearchPage params
|
|
40
|
+
keywords: z
|
|
41
|
+
.union([z.string(), booleanExpressionSchema])
|
|
42
|
+
.optional()
|
|
43
|
+
.describe("Keywords (string or structured boolean expression)"),
|
|
44
|
+
currentCompany: z
|
|
45
|
+
.array(z.string())
|
|
46
|
+
.optional()
|
|
47
|
+
.describe("Current company IDs (SearchPage)"),
|
|
48
|
+
pastCompany: z
|
|
49
|
+
.array(z.string())
|
|
50
|
+
.optional()
|
|
51
|
+
.describe("Past company IDs (SearchPage)"),
|
|
52
|
+
geoUrn: z
|
|
53
|
+
.array(z.string())
|
|
54
|
+
.optional()
|
|
55
|
+
.describe("Geographic URN IDs (SearchPage)"),
|
|
56
|
+
industry: z
|
|
57
|
+
.array(z.string())
|
|
58
|
+
.optional()
|
|
59
|
+
.describe("Industry IDs (SearchPage)"),
|
|
60
|
+
school: z
|
|
61
|
+
.array(z.string())
|
|
62
|
+
.optional()
|
|
63
|
+
.describe("School IDs (SearchPage)"),
|
|
64
|
+
network: z
|
|
65
|
+
.array(z.string())
|
|
66
|
+
.optional()
|
|
67
|
+
.describe('Connection degree codes: "F", "S", "O" (SearchPage)'),
|
|
68
|
+
profileLanguage: z
|
|
69
|
+
.array(z.string())
|
|
70
|
+
.optional()
|
|
71
|
+
.describe("Profile language codes (SearchPage)"),
|
|
72
|
+
serviceCategory: z
|
|
73
|
+
.array(z.string())
|
|
74
|
+
.optional()
|
|
75
|
+
.describe("Service category IDs (SearchPage)"),
|
|
76
|
+
// SNSearchPage params
|
|
77
|
+
filters: z
|
|
78
|
+
.array(snFilterSchema)
|
|
79
|
+
.optional()
|
|
80
|
+
.describe("Sales Navigator filters (SNSearchPage)"),
|
|
81
|
+
// Parameterised template params
|
|
82
|
+
slug: z
|
|
83
|
+
.string()
|
|
84
|
+
.optional()
|
|
85
|
+
.describe("Company or school slug (OrganizationPeople, Alumni)"),
|
|
86
|
+
id: z
|
|
87
|
+
.string()
|
|
88
|
+
.optional()
|
|
89
|
+
.describe("Entity ID (Group, Event, SNListPage, SNOrgsListsPage, TProjectPage, RProjectPage)"),
|
|
90
|
+
}, async (args) => {
|
|
91
|
+
try {
|
|
92
|
+
// Strip undefined values to satisfy exactOptionalPropertyTypes
|
|
93
|
+
const input = {
|
|
94
|
+
sourceType: args.sourceType,
|
|
95
|
+
...(args.keywords !== undefined && { keywords: args.keywords }),
|
|
96
|
+
...(args.currentCompany !== undefined && { currentCompany: args.currentCompany }),
|
|
97
|
+
...(args.pastCompany !== undefined && { pastCompany: args.pastCompany }),
|
|
98
|
+
...(args.geoUrn !== undefined && { geoUrn: args.geoUrn }),
|
|
99
|
+
...(args.industry !== undefined && { industry: args.industry }),
|
|
100
|
+
...(args.school !== undefined && { school: args.school }),
|
|
101
|
+
...(args.network !== undefined && { network: args.network }),
|
|
102
|
+
...(args.profileLanguage !== undefined && { profileLanguage: args.profileLanguage }),
|
|
103
|
+
...(args.serviceCategory !== undefined && { serviceCategory: args.serviceCategory }),
|
|
104
|
+
...(args.filters !== undefined && { filters: args.filters }),
|
|
105
|
+
...(args.slug !== undefined && { slug: args.slug }),
|
|
106
|
+
...(args.id !== undefined && { id: args.id }),
|
|
107
|
+
};
|
|
108
|
+
const result = buildLinkedInUrl(input);
|
|
109
|
+
return mcpSuccess(JSON.stringify(result, null, 2));
|
|
110
|
+
}
|
|
111
|
+
catch (error) {
|
|
112
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
113
|
+
return mcpError(message);
|
|
114
|
+
}
|
|
115
|
+
});
|
|
116
|
+
}
|
|
117
|
+
//# sourceMappingURL=build-linkedin-url.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"build-linkedin-url.js","sourceRoot":"","sources":["../../src/tools/build-linkedin-url.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"build-linkedin-url.test.d.ts","sourceRoot":"","sources":["../../src/tools/build-linkedin-url.test.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
// SPDX-License-Identifier: AGPL-3.0-only
|
|
2
|
+
// Copyright (C) 2026 Oleksii PELYKH
|
|
3
|
+
import { describe, expect, it, beforeEach, vi } from "vitest";
|
|
4
|
+
import { registerBuildLinkedInUrl } from "./build-linkedin-url.js";
|
|
5
|
+
import { createMockServer } from "./testing/mock-server.js";
|
|
6
|
+
function extractText(result) {
|
|
7
|
+
const r = result;
|
|
8
|
+
return r.content?.[0]?.text ?? "";
|
|
9
|
+
}
|
|
10
|
+
describe("registerBuildLinkedInUrl", () => {
|
|
11
|
+
beforeEach(() => {
|
|
12
|
+
vi.clearAllMocks();
|
|
13
|
+
});
|
|
14
|
+
it("registers a tool named build-linkedin-url", () => {
|
|
15
|
+
const { server } = createMockServer();
|
|
16
|
+
registerBuildLinkedInUrl(server);
|
|
17
|
+
expect(server.tool).toHaveBeenCalledOnce();
|
|
18
|
+
expect(server.tool).toHaveBeenCalledWith("build-linkedin-url", expect.any(String), expect.any(Object), expect.any(Function));
|
|
19
|
+
});
|
|
20
|
+
it("builds SearchPage URL with keywords", async () => {
|
|
21
|
+
const { server, getHandler } = createMockServer();
|
|
22
|
+
registerBuildLinkedInUrl(server);
|
|
23
|
+
const handler = getHandler("build-linkedin-url");
|
|
24
|
+
const result = await handler({
|
|
25
|
+
sourceType: "SearchPage",
|
|
26
|
+
keywords: "software engineer",
|
|
27
|
+
});
|
|
28
|
+
const parsed = JSON.parse(extractText(result));
|
|
29
|
+
expect(parsed.sourceType).toBe("SearchPage");
|
|
30
|
+
expect(parsed.url).toContain("/search/results/people/");
|
|
31
|
+
expect(parsed.url).toContain("keywords=");
|
|
32
|
+
});
|
|
33
|
+
it("builds fixed URL for MyConnections", async () => {
|
|
34
|
+
const { server, getHandler } = createMockServer();
|
|
35
|
+
registerBuildLinkedInUrl(server);
|
|
36
|
+
const handler = getHandler("build-linkedin-url");
|
|
37
|
+
const result = await handler({
|
|
38
|
+
sourceType: "MyConnections",
|
|
39
|
+
});
|
|
40
|
+
const parsed = JSON.parse(extractText(result));
|
|
41
|
+
expect(parsed.sourceType).toBe("MyConnections");
|
|
42
|
+
expect(parsed.url).toContain("/connections/");
|
|
43
|
+
});
|
|
44
|
+
it("builds parameterised URL for OrganizationPeople", async () => {
|
|
45
|
+
const { server, getHandler } = createMockServer();
|
|
46
|
+
registerBuildLinkedInUrl(server);
|
|
47
|
+
const handler = getHandler("build-linkedin-url");
|
|
48
|
+
const result = await handler({
|
|
49
|
+
sourceType: "OrganizationPeople",
|
|
50
|
+
slug: "google",
|
|
51
|
+
});
|
|
52
|
+
const parsed = JSON.parse(extractText(result));
|
|
53
|
+
expect(parsed.url).toBe("https://www.linkedin.com/company/google/people/");
|
|
54
|
+
});
|
|
55
|
+
it("returns error for invalid sourceType", async () => {
|
|
56
|
+
const { server, getHandler } = createMockServer();
|
|
57
|
+
registerBuildLinkedInUrl(server);
|
|
58
|
+
const handler = getHandler("build-linkedin-url");
|
|
59
|
+
const result = await handler({
|
|
60
|
+
sourceType: "InvalidType",
|
|
61
|
+
});
|
|
62
|
+
expect(result.isError).toBe(true);
|
|
63
|
+
expect(extractText(result)).toContain("Unknown source type");
|
|
64
|
+
});
|
|
65
|
+
it("returns error when required param is missing", async () => {
|
|
66
|
+
const { server, getHandler } = createMockServer();
|
|
67
|
+
registerBuildLinkedInUrl(server);
|
|
68
|
+
const handler = getHandler("build-linkedin-url");
|
|
69
|
+
const result = await handler({
|
|
70
|
+
sourceType: "OrganizationPeople",
|
|
71
|
+
// missing slug
|
|
72
|
+
});
|
|
73
|
+
expect(result.isError).toBe(true);
|
|
74
|
+
expect(extractText(result)).toContain("Missing required parameter");
|
|
75
|
+
});
|
|
76
|
+
it("builds SNSearchPage URL with filters", async () => {
|
|
77
|
+
const { server, getHandler } = createMockServer();
|
|
78
|
+
registerBuildLinkedInUrl(server);
|
|
79
|
+
const handler = getHandler("build-linkedin-url");
|
|
80
|
+
const result = await handler({
|
|
81
|
+
sourceType: "SNSearchPage",
|
|
82
|
+
keywords: "engineer",
|
|
83
|
+
filters: [
|
|
84
|
+
{
|
|
85
|
+
type: "CURRENT_COMPANY",
|
|
86
|
+
values: [
|
|
87
|
+
{
|
|
88
|
+
id: "urn:li:organization:1441",
|
|
89
|
+
text: "Google",
|
|
90
|
+
selectionType: "INCLUDED",
|
|
91
|
+
},
|
|
92
|
+
],
|
|
93
|
+
},
|
|
94
|
+
],
|
|
95
|
+
});
|
|
96
|
+
const parsed = JSON.parse(extractText(result));
|
|
97
|
+
expect(parsed.sourceType).toBe("SNSearchPage");
|
|
98
|
+
expect(parsed.url).toContain("/sales/search/people");
|
|
99
|
+
});
|
|
100
|
+
});
|
|
101
|
+
//# sourceMappingURL=build-linkedin-url.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"build-linkedin-url.test.js","sourceRoot":"","sources":["../../src/tools/build-linkedin-url.test.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
/** Register the {@link https://github.com/alexey-pelykh/lhremote#collect-people | collect-people} MCP tool. */
|
|
3
|
+
export declare function registerCollectPeople(server: McpServer): void;
|
|
4
|
+
//# sourceMappingURL=collect-people.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"collect-people.d.ts","sourceRoot":"","sources":["../../src/tools/collect-people.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,+GAA+G;AAC/G,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+D7D"}
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
// SPDX-License-Identifier: AGPL-3.0-only
|
|
2
|
+
// Copyright (C) 2026 Oleksii PELYKH
|
|
3
|
+
import { CollectionBusyError, CollectionError, collectPeople, } from "@lhremote/core";
|
|
4
|
+
import { z } from "zod";
|
|
5
|
+
import { cdpConnectionSchema, mcpCatchAll, mcpError, mcpSuccess } from "../helpers.js";
|
|
6
|
+
/** Register the {@link https://github.com/alexey-pelykh/lhremote#collect-people | collect-people} MCP tool. */
|
|
7
|
+
export function registerCollectPeople(server) {
|
|
8
|
+
server.tool("collect-people", "Collect people from a LinkedIn page into a campaign. Detects the source type from the URL automatically. Returns immediately — poll campaign-status for progress.", {
|
|
9
|
+
campaignId: z
|
|
10
|
+
.number()
|
|
11
|
+
.int()
|
|
12
|
+
.positive()
|
|
13
|
+
.describe("Campaign ID to collect people into"),
|
|
14
|
+
sourceUrl: z
|
|
15
|
+
.string()
|
|
16
|
+
.url()
|
|
17
|
+
.describe("LinkedIn page URL to collect people from (e.g., search results, company people, group members)"),
|
|
18
|
+
limit: z
|
|
19
|
+
.number()
|
|
20
|
+
.int()
|
|
21
|
+
.positive()
|
|
22
|
+
.optional()
|
|
23
|
+
.describe("Maximum number of profiles to collect"),
|
|
24
|
+
maxPages: z
|
|
25
|
+
.number()
|
|
26
|
+
.int()
|
|
27
|
+
.positive()
|
|
28
|
+
.optional()
|
|
29
|
+
.describe("Maximum number of pages to process"),
|
|
30
|
+
pageSize: z
|
|
31
|
+
.number()
|
|
32
|
+
.int()
|
|
33
|
+
.positive()
|
|
34
|
+
.optional()
|
|
35
|
+
.describe("Number of results per page"),
|
|
36
|
+
sourceType: z
|
|
37
|
+
.string()
|
|
38
|
+
.optional()
|
|
39
|
+
.describe("Explicit source type to bypass URL detection (e.g., SearchPage, MyConnections)"),
|
|
40
|
+
...cdpConnectionSchema,
|
|
41
|
+
}, async ({ campaignId, sourceUrl, limit, maxPages, pageSize, sourceType, cdpPort, cdpHost, allowRemote }) => {
|
|
42
|
+
try {
|
|
43
|
+
const result = await collectPeople({
|
|
44
|
+
campaignId,
|
|
45
|
+
sourceUrl,
|
|
46
|
+
...(limit !== undefined && { limit }),
|
|
47
|
+
...(maxPages !== undefined && { maxPages }),
|
|
48
|
+
...(pageSize !== undefined && { pageSize }),
|
|
49
|
+
...(sourceType !== undefined && { sourceType }),
|
|
50
|
+
cdpPort,
|
|
51
|
+
...(cdpHost !== undefined && { cdpHost }),
|
|
52
|
+
...(allowRemote !== undefined && { allowRemote }),
|
|
53
|
+
});
|
|
54
|
+
return mcpSuccess(JSON.stringify(result, null, 2));
|
|
55
|
+
}
|
|
56
|
+
catch (error) {
|
|
57
|
+
if (error instanceof CollectionBusyError) {
|
|
58
|
+
return mcpError(`Cannot collect — instance is busy (state: ${error.runnerState})`);
|
|
59
|
+
}
|
|
60
|
+
if (error instanceof CollectionError) {
|
|
61
|
+
return mcpError(`Collection failed: ${error.message}`);
|
|
62
|
+
}
|
|
63
|
+
return mcpCatchAll(error, "Failed to collect people");
|
|
64
|
+
}
|
|
65
|
+
});
|
|
66
|
+
}
|
|
67
|
+
//# sourceMappingURL=collect-people.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"collect-people.js","sourceRoot":"","sources":["../../src/tools/collect-people.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAGpC,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEvF,+GAA+G;AAC/G,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,mKAAmK,EACnK;QACE,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,CAAC,oCAAoC,CAAC;QACjD,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,CAAC,gGAAgG,CAAC;QAC7G,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,uCAAuC,CAAC;QACpD,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,oCAAoC,CAAC;QACjD,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,4BAA4B,CAAC;QACzC,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,gFAAgF,CAAC;QAC7F,GAAG,mBAAmB;KACvB,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QACxG,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;gBACjC,UAAU;gBACV,SAAS;gBACT,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC;gBACrC,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;gBAC3C,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;gBAC3C,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,CAAC;gBAC/C,OAAO;gBACP,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,CAAC;gBACzC,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,CAAC;aAClD,CAAC,CAAC;YACH,OAAO,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;gBACzC,OAAO,QAAQ,CAAC,6CAA6C,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;YACrF,CAAC;YACD,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;gBACrC,OAAO,QAAQ,CAAC,sBAAsB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,WAAW,CAAC,KAAK,EAAE,0BAA0B,CAAC,CAAC;QACxD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"collect-people.test.d.ts","sourceRoot":"","sources":["../../src/tools/collect-people.test.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,129 @@
|
|
|
1
|
+
// SPDX-License-Identifier: AGPL-3.0-only
|
|
2
|
+
// Copyright (C) 2026 Oleksii PELYKH
|
|
3
|
+
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
|
|
4
|
+
vi.mock("@lhremote/core", async (importOriginal) => {
|
|
5
|
+
const actual = await importOriginal();
|
|
6
|
+
return {
|
|
7
|
+
...actual,
|
|
8
|
+
collectPeople: vi.fn(),
|
|
9
|
+
};
|
|
10
|
+
});
|
|
11
|
+
import { CollectionBusyError, CollectionError, collectPeople, } from "@lhremote/core";
|
|
12
|
+
import { registerCollectPeople } from "./collect-people.js";
|
|
13
|
+
import { describeInfrastructureErrors } from "./testing/infrastructure-errors.js";
|
|
14
|
+
import { createMockServer } from "./testing/mock-server.js";
|
|
15
|
+
describe("registerCollectPeople", () => {
|
|
16
|
+
beforeEach(() => {
|
|
17
|
+
vi.clearAllMocks();
|
|
18
|
+
});
|
|
19
|
+
afterEach(() => {
|
|
20
|
+
vi.restoreAllMocks();
|
|
21
|
+
});
|
|
22
|
+
it("registers a tool named collect-people", () => {
|
|
23
|
+
const { server } = createMockServer();
|
|
24
|
+
registerCollectPeople(server);
|
|
25
|
+
expect(server.tool).toHaveBeenCalledOnce();
|
|
26
|
+
expect(server.tool).toHaveBeenCalledWith("collect-people", expect.any(String), expect.any(Object), expect.any(Function));
|
|
27
|
+
});
|
|
28
|
+
it("returns success result with detected source type", async () => {
|
|
29
|
+
const { server, getHandler } = createMockServer();
|
|
30
|
+
registerCollectPeople(server);
|
|
31
|
+
vi.mocked(collectPeople).mockResolvedValue({
|
|
32
|
+
success: true,
|
|
33
|
+
campaignId: 42,
|
|
34
|
+
sourceType: "SearchPage",
|
|
35
|
+
});
|
|
36
|
+
const handler = getHandler("collect-people");
|
|
37
|
+
const result = await handler({
|
|
38
|
+
campaignId: 42,
|
|
39
|
+
sourceUrl: "https://www.linkedin.com/search/results/people/",
|
|
40
|
+
cdpPort: 9222,
|
|
41
|
+
});
|
|
42
|
+
expect(result).toEqual({
|
|
43
|
+
content: [
|
|
44
|
+
{
|
|
45
|
+
type: "text",
|
|
46
|
+
text: JSON.stringify({
|
|
47
|
+
success: true,
|
|
48
|
+
campaignId: 42,
|
|
49
|
+
sourceType: "SearchPage",
|
|
50
|
+
}, null, 2),
|
|
51
|
+
},
|
|
52
|
+
],
|
|
53
|
+
});
|
|
54
|
+
});
|
|
55
|
+
it("passes all arguments to the operation", async () => {
|
|
56
|
+
const { server, getHandler } = createMockServer();
|
|
57
|
+
registerCollectPeople(server);
|
|
58
|
+
vi.mocked(collectPeople).mockResolvedValue({
|
|
59
|
+
success: true,
|
|
60
|
+
campaignId: 42,
|
|
61
|
+
sourceType: "SearchPage",
|
|
62
|
+
});
|
|
63
|
+
const handler = getHandler("collect-people");
|
|
64
|
+
await handler({
|
|
65
|
+
campaignId: 42,
|
|
66
|
+
sourceUrl: "https://www.linkedin.com/search/results/people/",
|
|
67
|
+
limit: 100,
|
|
68
|
+
maxPages: 5,
|
|
69
|
+
pageSize: 25,
|
|
70
|
+
sourceType: "SearchPage",
|
|
71
|
+
cdpPort: 9222,
|
|
72
|
+
});
|
|
73
|
+
expect(collectPeople).toHaveBeenCalledWith(expect.objectContaining({
|
|
74
|
+
campaignId: 42,
|
|
75
|
+
sourceUrl: "https://www.linkedin.com/search/results/people/",
|
|
76
|
+
limit: 100,
|
|
77
|
+
maxPages: 5,
|
|
78
|
+
pageSize: 25,
|
|
79
|
+
sourceType: "SearchPage",
|
|
80
|
+
cdpPort: 9222,
|
|
81
|
+
}));
|
|
82
|
+
});
|
|
83
|
+
it("returns error when instance is busy", async () => {
|
|
84
|
+
const { server, getHandler } = createMockServer();
|
|
85
|
+
registerCollectPeople(server);
|
|
86
|
+
vi.mocked(collectPeople).mockRejectedValue(new CollectionBusyError("running"));
|
|
87
|
+
const handler = getHandler("collect-people");
|
|
88
|
+
const result = await handler({
|
|
89
|
+
campaignId: 42,
|
|
90
|
+
sourceUrl: "https://www.linkedin.com/search/results/people/",
|
|
91
|
+
cdpPort: 9222,
|
|
92
|
+
});
|
|
93
|
+
expect(result).toEqual({
|
|
94
|
+
isError: true,
|
|
95
|
+
content: [
|
|
96
|
+
{
|
|
97
|
+
type: "text",
|
|
98
|
+
text: "Cannot collect — instance is busy (state: running)",
|
|
99
|
+
},
|
|
100
|
+
],
|
|
101
|
+
});
|
|
102
|
+
});
|
|
103
|
+
it("returns error for unrecognized source URL", async () => {
|
|
104
|
+
const { server, getHandler } = createMockServer();
|
|
105
|
+
registerCollectPeople(server);
|
|
106
|
+
vi.mocked(collectPeople).mockRejectedValue(new CollectionError("Unrecognized source URL: https://www.linkedin.com/unknown/"));
|
|
107
|
+
const handler = getHandler("collect-people");
|
|
108
|
+
const result = await handler({
|
|
109
|
+
campaignId: 42,
|
|
110
|
+
sourceUrl: "https://www.linkedin.com/unknown/",
|
|
111
|
+
cdpPort: 9222,
|
|
112
|
+
});
|
|
113
|
+
expect(result).toEqual({
|
|
114
|
+
isError: true,
|
|
115
|
+
content: [
|
|
116
|
+
{
|
|
117
|
+
type: "text",
|
|
118
|
+
text: "Collection failed: Unrecognized source URL: https://www.linkedin.com/unknown/",
|
|
119
|
+
},
|
|
120
|
+
],
|
|
121
|
+
});
|
|
122
|
+
});
|
|
123
|
+
describeInfrastructureErrors(registerCollectPeople, "collect-people", () => ({
|
|
124
|
+
campaignId: 42,
|
|
125
|
+
sourceUrl: "https://www.linkedin.com/search/results/people/",
|
|
126
|
+
cdpPort: 9222,
|
|
127
|
+
}), (error) => vi.mocked(collectPeople).mockRejectedValue(error), "Failed to collect people");
|
|
128
|
+
});
|
|
129
|
+
//# sourceMappingURL=collect-people.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"collect-people.test.js","sourceRoot":"","sources":["../../src/tools/collect-people.test.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
/** Register the {@link https://github.com/alexey-pelykh/lhremote#create-collection | create-collection} MCP tool. */
|
|
3
|
+
export declare function registerCreateCollection(server: McpServer): void;
|
|
4
|
+
//# sourceMappingURL=create-collection.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"create-collection.d.ts","sourceRoot":"","sources":["../../src/tools/create-collection.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,qHAAqH;AACrH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoBhE"}
|