@klority/mcp-server 0.0.0-stage → 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.
@@ -0,0 +1,88 @@
1
+ import { z } from "zod";
2
+ export function registerWikiTools(server, client) {
3
+ // 1. Search Wiki PRDs & Documentation
4
+ server.tool("klority_search_wiki", "Search documentation, PRDs, architecture specifications, and technical guides in Klority Wiki.", {
5
+ query: z.string().describe("Search query, feature name, or technical concept"),
6
+ projectId: z.string().optional().describe("Filter by specific Project UUID")
7
+ }, async ({ query, projectId }) => {
8
+ try {
9
+ const res = await client.searchPages({ query, projectId });
10
+ if (!res.pages || res.pages.length === 0) {
11
+ return {
12
+ content: [{ type: "text", text: `No wiki documentation found matching query "${query}".` }]
13
+ };
14
+ }
15
+ const pageList = res.pages.map(p => `- **${p.title}** (ID: \`${p.id}\`)\n *Updated*: ${new Date(p.updatedAt).toLocaleDateString()}\n ${p.content ? p.content.slice(0, 180) + "..." : "*(empty content)*"}`).join("\n\n");
16
+ return {
17
+ content: [
18
+ {
19
+ type: "text",
20
+ text: `### Found ${res.pages.length} Wiki Page(s):\n\n${pageList}`
21
+ }
22
+ ]
23
+ };
24
+ }
25
+ catch (err) {
26
+ return {
27
+ isError: true,
28
+ content: [{ type: "text", text: `Error searching wiki: ${err.message}` }]
29
+ };
30
+ }
31
+ });
32
+ // 2. Get Full Page Details
33
+ server.tool("klority_get_page", "Retrieve full Markdown content, Mermaid diagrams, and requirements for a specific Klority Wiki document.", {
34
+ pageId: z.string().describe("Page UUID or slug identifier")
35
+ }, async ({ pageId }) => {
36
+ try {
37
+ const page = await client.getPage(pageId);
38
+ const text = [
39
+ `# ${page.title}`,
40
+ `*Page ID*: \`${page.id}\` | *Updated*: ${new Date(page.updatedAt).toLocaleDateString()}`,
41
+ `\n---`,
42
+ page.content || "*(No document content)*"
43
+ ].join("\n");
44
+ return {
45
+ content: [{ type: "text", text }]
46
+ };
47
+ }
48
+ catch (err) {
49
+ return {
50
+ isError: true,
51
+ content: [{ type: "text", text: `Error retrieving wiki page ${pageId}: ${err.message}` }]
52
+ };
53
+ }
54
+ });
55
+ // 3. Create or Update Page
56
+ server.tool("klority_create_or_update_page", "Create a new documentation page or update an existing page in Klority Wiki (e.g. for PRDs, ADRs, or API specs).", {
57
+ projectId: z.string().describe("Project UUID"),
58
+ title: z.string().min(1).describe("Document title"),
59
+ content: z.string().describe("Markdown content of the document"),
60
+ pageId: z.string().optional().describe("Existing Page UUID to update (leave empty to create new)"),
61
+ parentPageId: z.string().optional().describe("Parent folder/page UUID for hierarchical organization")
62
+ }, async ({ projectId, title, content, pageId, parentPageId }) => {
63
+ try {
64
+ const result = await client.createOrUpdatePage({
65
+ projectId,
66
+ title,
67
+ content,
68
+ pageId,
69
+ parentPageId
70
+ });
71
+ return {
72
+ content: [
73
+ {
74
+ type: "text",
75
+ text: `✅ **Wiki Page ${pageId ? "Updated" : "Created"} Successfully!**\n- **Title**: ${result.title}\n- **ID**: \`${result.id}\``
76
+ }
77
+ ]
78
+ };
79
+ }
80
+ catch (err) {
81
+ return {
82
+ isError: true,
83
+ content: [{ type: "text", text: `Error saving wiki page: ${err.message}` }]
84
+ };
85
+ }
86
+ });
87
+ }
88
+ //# sourceMappingURL=wiki.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wiki.js","sourceRoot":"","sources":["../../src/tools/wiki.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,45 @@
1
1
  {
2
2
  "name": "@klority/mcp-server",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "1.0.0",
4
+ "description": "Official Model Context Protocol (MCP) server for Klority — Tasks, Wiki PRDs, Test Management, and CRM",
5
+ "type": "module",
6
+ "bin": {
7
+ "klority-mcp": "dist/index.js",
8
+ "mcp-server": "dist/index.js"
9
+ },
10
+ "main": "./dist/index.js",
11
+ "types": "./dist/index.d.ts",
12
+ "files": [
13
+ "dist",
14
+ "README.md"
15
+ ],
16
+ "publishConfig": {
17
+ "access": "public"
18
+ },
19
+ "scripts": {
20
+ "build": "tsc",
21
+ "dev": "tsc -w",
22
+ "start": "node dist/index.js",
23
+ "prepublishOnly": "npm run build"
24
+ },
25
+ "keywords": [
26
+ "klority",
27
+ "mcp",
28
+ "model-context-protocol",
29
+ "anthropic",
30
+ "claude",
31
+ "cursor",
32
+ "sdlc",
33
+ "ai-agent"
34
+ ],
35
+ "author": "Klority <support@klority.com>",
36
+ "license": "MIT",
37
+ "dependencies": {
38
+ "@modelcontextprotocol/sdk": "^1.32.1",
39
+ "zod": "^3.22.4"
40
+ },
41
+ "devDependencies": {
42
+ "@types/node": "^20.11.0",
43
+ "typescript": "^5.3.3"
44
+ }
45
+ }