@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.
- package/README.md +101 -2
- package/dist/client.d.ts +195 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/client.js +180 -0
- package/dist/client.js.map +1 -0
- package/dist/index.d.ts +8 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +70 -0
- package/dist/index.js.map +1 -0
- package/dist/prompts/index.d.ts +4 -0
- package/dist/prompts/index.d.ts.map +1 -0
- package/dist/prompts/index.js +97 -0
- package/dist/prompts/index.js.map +1 -0
- package/dist/resources/index.d.ts +4 -0
- package/dist/resources/index.d.ts.map +1 -0
- package/dist/resources/index.js +86 -0
- package/dist/resources/index.js.map +1 -0
- package/dist/tools/crm.d.ts +4 -0
- package/dist/tools/crm.d.ts.map +1 -0
- package/dist/tools/crm.js +32 -0
- package/dist/tools/crm.js.map +1 -0
- package/dist/tools/qa.d.ts +4 -0
- package/dist/tools/qa.d.ts.map +1 -0
- package/dist/tools/qa.js +102 -0
- package/dist/tools/qa.js.map +1 -0
- package/dist/tools/tasks.d.ts +4 -0
- package/dist/tools/tasks.d.ts.map +1 -0
- package/dist/tools/tasks.js +172 -0
- package/dist/tools/tasks.js.map +1 -0
- package/dist/tools/wiki.d.ts +4 -0
- package/dist/tools/wiki.d.ts.map +1 -0
- package/dist/tools/wiki.js +88 -0
- package/dist/tools/wiki.js.map +1 -0
- package/package.json +43 -4
package/README.md
CHANGED
|
@@ -1,3 +1,102 @@
|
|
|
1
|
-
#
|
|
1
|
+
# ๐ @klority/mcp-server
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
> Official **Model Context Protocol (MCP)** server for **[Klority](https://klority.com)** โ The Unified Engineering & Operations Platform.
|
|
4
|
+
|
|
5
|
+
Connects your AI coding assistants (**Cursor**, **Claude Desktop**, **Claude Code CLI**, **Cline**, **Windsurf**) directly to your Klority workspace:
|
|
6
|
+
- ๐ **Agile Tasks & Sprints**: Query tickets, update statuses, assign issues, and post AI work logs.
|
|
7
|
+
- ๐ **Wiki & PRDs**: Semantic search across architecture specs, PRDs, and ADRs.
|
|
8
|
+
- ๐งช **QA & Acceptance Testing**: Retrieve test cases, preconditions, steps, and ingest automated test runs.
|
|
9
|
+
- ๐ผ **CRM Context**: Look up client accounts, deal pipelines, and customer feedback.
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## ๐ Quickstart
|
|
14
|
+
|
|
15
|
+
You don't need to install anything globally. Run directly via `npx`:
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
npx -y @klority/mcp-server
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## โ๏ธ Configuration
|
|
24
|
+
|
|
25
|
+
### 1. Claude Desktop
|
|
26
|
+
|
|
27
|
+
Add this to your `claude_desktop_config.json`:
|
|
28
|
+
|
|
29
|
+
* **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
30
|
+
* **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
|
|
31
|
+
* **Linux**: `~/.config/Claude/claude_desktop_config.json`
|
|
32
|
+
|
|
33
|
+
```json
|
|
34
|
+
{
|
|
35
|
+
"mcpServers": {
|
|
36
|
+
"klority": {
|
|
37
|
+
"command": "npx",
|
|
38
|
+
"args": ["-y", "@klority/mcp-server"],
|
|
39
|
+
"env": {
|
|
40
|
+
"KLORITY_API_TOKEN": "klor_pat_YOUR_TOKEN_HERE",
|
|
41
|
+
"KLORITY_WORKSPACE": "your-workspace-slug",
|
|
42
|
+
"KLORITY_API_URL": "https://app.klority.com/api"
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
### 2. Cursor IDE
|
|
52
|
+
|
|
53
|
+
Add this to `~/.cursor/mcp.json` or your project's `.cursor/mcp.json`:
|
|
54
|
+
|
|
55
|
+
```json
|
|
56
|
+
{
|
|
57
|
+
"mcpServers": {
|
|
58
|
+
"klority": {
|
|
59
|
+
"command": "npx",
|
|
60
|
+
"args": ["-y", "@klority/mcp-server"],
|
|
61
|
+
"env": {
|
|
62
|
+
"KLORITY_API_TOKEN": "klor_pat_YOUR_TOKEN_HERE",
|
|
63
|
+
"KLORITY_WORKSPACE": "your-workspace-slug"
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
---
|
|
71
|
+
|
|
72
|
+
### 3. Claude Code CLI
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
claude mcp add klority -e KLORITY_API_TOKEN=klor_pat_YOUR_TOKEN -e KLORITY_WORKSPACE=your-workspace-slug -- npx -y @klority/mcp-server
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## ๐ Available Tools
|
|
81
|
+
|
|
82
|
+
| Tool | Description |
|
|
83
|
+
|---|---|
|
|
84
|
+
| `klority_search_tasks` | Search Agile tasks by title, description, project, or sprint. |
|
|
85
|
+
| `klority_get_task` | Fetch full details, acceptance criteria, and discussion thread for a task. |
|
|
86
|
+
| `klority_create_task` | Create a new Story, Task, or Bug directly on the sprint board. |
|
|
87
|
+
| `klority_update_task_status` | Move a ticket across board columns and add explanation notes. |
|
|
88
|
+
| `klority_add_task_comment` | Post an update or question to a ticket comment thread. |
|
|
89
|
+
| `klority_list_sprints` | List sprints and active milestones for a project. |
|
|
90
|
+
| `klority_search_wiki` | Search company PRDs, specs, and engineering wikis. |
|
|
91
|
+
| `klority_get_page` | Fetch Markdown content and Mermaid diagrams for a wiki page. |
|
|
92
|
+
| `klority_create_or_update_page` | Create or update wiki documentation (ADRs, release notes). |
|
|
93
|
+
| `klority_get_qa_criteria` | Fetch test cases and acceptance criteria to generate tests. |
|
|
94
|
+
| `klority_create_test_case` | Add formal test cases to the QA repository. |
|
|
95
|
+
| `klority_record_test_runs` | Ingest test results (Playwright/Jest) into Klority QA cycles. |
|
|
96
|
+
| `klority_search_crm` | Search CRM accounts, deals, and contacts. |
|
|
97
|
+
|
|
98
|
+
---
|
|
99
|
+
|
|
100
|
+
## ๐ License
|
|
101
|
+
|
|
102
|
+
MIT ยฉ [Vellsoft Inc.](https://klority.com)
|
package/dist/client.d.ts
ADDED
|
@@ -0,0 +1,195 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Klority API Client for Model Context Protocol (MCP) Server
|
|
3
|
+
* Handles communication with Klority Cloud or Self-Hosted REST/IDE API
|
|
4
|
+
*/
|
|
5
|
+
export interface KlorityClientConfig {
|
|
6
|
+
apiUrl: string;
|
|
7
|
+
apiToken: string;
|
|
8
|
+
workspaceSlug: string;
|
|
9
|
+
}
|
|
10
|
+
export interface TaskItem {
|
|
11
|
+
id: string;
|
|
12
|
+
customId: string | null;
|
|
13
|
+
title: string;
|
|
14
|
+
description: string | null;
|
|
15
|
+
type: string;
|
|
16
|
+
priority: string;
|
|
17
|
+
labels: string[] | null;
|
|
18
|
+
customFields: Record<string, any> | null;
|
|
19
|
+
columnId: string;
|
|
20
|
+
sprintId: string | null;
|
|
21
|
+
createdAt: string;
|
|
22
|
+
updatedAt?: string;
|
|
23
|
+
comments?: Array<{
|
|
24
|
+
id: string;
|
|
25
|
+
content: string;
|
|
26
|
+
createdAt: string;
|
|
27
|
+
authorName?: string;
|
|
28
|
+
}>;
|
|
29
|
+
}
|
|
30
|
+
export interface PageItem {
|
|
31
|
+
id: string;
|
|
32
|
+
projectId: string;
|
|
33
|
+
title: string;
|
|
34
|
+
content: string | null;
|
|
35
|
+
updatedAt: string;
|
|
36
|
+
createdAt: string;
|
|
37
|
+
}
|
|
38
|
+
export interface TestCaseItem {
|
|
39
|
+
id: string;
|
|
40
|
+
customId: string | null;
|
|
41
|
+
projectId: string;
|
|
42
|
+
moduleId: string | null;
|
|
43
|
+
title: string;
|
|
44
|
+
description: string | null;
|
|
45
|
+
validationType: string | null;
|
|
46
|
+
status: string;
|
|
47
|
+
priority: string;
|
|
48
|
+
preconditions: string | null;
|
|
49
|
+
steps: any;
|
|
50
|
+
expectedResult: string | null;
|
|
51
|
+
updatedAt: string;
|
|
52
|
+
}
|
|
53
|
+
export declare class KlorityClient {
|
|
54
|
+
private apiUrl;
|
|
55
|
+
private apiToken;
|
|
56
|
+
private workspaceSlug;
|
|
57
|
+
constructor(config?: Partial<KlorityClientConfig>);
|
|
58
|
+
private request;
|
|
59
|
+
/**
|
|
60
|
+
* Verify token and workspace connection
|
|
61
|
+
*/
|
|
62
|
+
verifyAuth(): Promise<{
|
|
63
|
+
authenticated: boolean;
|
|
64
|
+
user: any;
|
|
65
|
+
workspace: any;
|
|
66
|
+
projects: any[];
|
|
67
|
+
}>;
|
|
68
|
+
/**
|
|
69
|
+
* Search tasks with optional filters
|
|
70
|
+
*/
|
|
71
|
+
searchTasks(params: {
|
|
72
|
+
query?: string;
|
|
73
|
+
projectId?: string;
|
|
74
|
+
sprintId?: string;
|
|
75
|
+
limit?: number;
|
|
76
|
+
since?: string;
|
|
77
|
+
}): Promise<{
|
|
78
|
+
tasks: TaskItem[];
|
|
79
|
+
count: number;
|
|
80
|
+
}>;
|
|
81
|
+
/**
|
|
82
|
+
* Get specific task by UUID or custom key (e.g. KLOR-104)
|
|
83
|
+
*/
|
|
84
|
+
getTask(taskId: string): Promise<TaskItem>;
|
|
85
|
+
/**
|
|
86
|
+
* Create a new task/story/bug
|
|
87
|
+
*/
|
|
88
|
+
createTask(data: {
|
|
89
|
+
projectId: string;
|
|
90
|
+
title: string;
|
|
91
|
+
description: string;
|
|
92
|
+
type?: string;
|
|
93
|
+
priority?: string;
|
|
94
|
+
columnId?: string;
|
|
95
|
+
sprintId?: string;
|
|
96
|
+
labels?: string[];
|
|
97
|
+
}): Promise<TaskItem>;
|
|
98
|
+
/**
|
|
99
|
+
* Update task status (column) and optionally leave a comment
|
|
100
|
+
*/
|
|
101
|
+
updateTaskStatus(taskId: string, columnId?: string, comment?: string): Promise<{
|
|
102
|
+
success: boolean;
|
|
103
|
+
taskId: string;
|
|
104
|
+
}>;
|
|
105
|
+
/**
|
|
106
|
+
* Post a comment to a task
|
|
107
|
+
*/
|
|
108
|
+
addTaskComment(taskId: string, content: string): Promise<{
|
|
109
|
+
success: boolean;
|
|
110
|
+
commentId: string;
|
|
111
|
+
}>;
|
|
112
|
+
/**
|
|
113
|
+
* List sprints in a project
|
|
114
|
+
*/
|
|
115
|
+
listSprints(projectId: string, state?: "active" | "future" | "closed"): Promise<{
|
|
116
|
+
sprints: any[];
|
|
117
|
+
}>;
|
|
118
|
+
/**
|
|
119
|
+
* Search wiki documentation and PRDs
|
|
120
|
+
*/
|
|
121
|
+
searchPages(params: {
|
|
122
|
+
query?: string;
|
|
123
|
+
projectId?: string;
|
|
124
|
+
since?: string;
|
|
125
|
+
}): Promise<{
|
|
126
|
+
pages: PageItem[];
|
|
127
|
+
count: number;
|
|
128
|
+
}>;
|
|
129
|
+
/**
|
|
130
|
+
* Get wiki page content by ID
|
|
131
|
+
*/
|
|
132
|
+
getPage(pageId: string): Promise<PageItem>;
|
|
133
|
+
/**
|
|
134
|
+
* Create or update a wiki page
|
|
135
|
+
*/
|
|
136
|
+
createOrUpdatePage(data: {
|
|
137
|
+
projectId: string;
|
|
138
|
+
title: string;
|
|
139
|
+
content: string;
|
|
140
|
+
pageId?: string;
|
|
141
|
+
parentPageId?: string;
|
|
142
|
+
}): Promise<PageItem>;
|
|
143
|
+
/**
|
|
144
|
+
* Fetch QA test cases / acceptance criteria
|
|
145
|
+
*/
|
|
146
|
+
getQACriteria(params: {
|
|
147
|
+
query?: string;
|
|
148
|
+
projectId?: string;
|
|
149
|
+
since?: string;
|
|
150
|
+
}): Promise<{
|
|
151
|
+
testCases: TestCaseItem[];
|
|
152
|
+
count: number;
|
|
153
|
+
}>;
|
|
154
|
+
/**
|
|
155
|
+
* Create a new test case
|
|
156
|
+
*/
|
|
157
|
+
createTestCase(data: {
|
|
158
|
+
projectId: string;
|
|
159
|
+
moduleId?: string;
|
|
160
|
+
title: string;
|
|
161
|
+
description?: string;
|
|
162
|
+
steps?: Array<{
|
|
163
|
+
step: string;
|
|
164
|
+
expected: string;
|
|
165
|
+
}>;
|
|
166
|
+
priority?: string;
|
|
167
|
+
preconditions?: string;
|
|
168
|
+
}): Promise<TestCaseItem>;
|
|
169
|
+
/**
|
|
170
|
+
* Ingest test run results (e.g. from Playwright, Jest, Vitest)
|
|
171
|
+
*/
|
|
172
|
+
recordTestRuns(data: {
|
|
173
|
+
projectId: string;
|
|
174
|
+
testCycleId?: string;
|
|
175
|
+
testCycleName?: string;
|
|
176
|
+
results: Array<{
|
|
177
|
+
testCaseId: string;
|
|
178
|
+
status: "Passed" | "Failed" | "Blocked";
|
|
179
|
+
executionTimeMs?: number;
|
|
180
|
+
comment?: string;
|
|
181
|
+
stepResults?: any;
|
|
182
|
+
}>;
|
|
183
|
+
}): Promise<{
|
|
184
|
+
success: boolean;
|
|
185
|
+
testCycleId: string;
|
|
186
|
+
runsRecorded: number;
|
|
187
|
+
}>;
|
|
188
|
+
/**
|
|
189
|
+
* Search CRM deals, companies, contacts
|
|
190
|
+
*/
|
|
191
|
+
searchCRM(query: string, entity?: "deal" | "company" | "contact"): Promise<{
|
|
192
|
+
results: any[];
|
|
193
|
+
}>;
|
|
194
|
+
}
|
|
195
|
+
//# sourceMappingURL=client.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
|
package/dist/client.js
ADDED
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Klority API Client for Model Context Protocol (MCP) Server
|
|
3
|
+
* Handles communication with Klority Cloud or Self-Hosted REST/IDE API
|
|
4
|
+
*/
|
|
5
|
+
export class KlorityClient {
|
|
6
|
+
apiUrl;
|
|
7
|
+
apiToken;
|
|
8
|
+
workspaceSlug;
|
|
9
|
+
constructor(config) {
|
|
10
|
+
this.apiUrl = (config?.apiUrl || process.env.KLORITY_API_URL || "https://app.klority.com/api").replace(/\/+$/, "");
|
|
11
|
+
this.apiToken = (config?.apiToken || process.env.KLORITY_API_TOKEN || "").trim();
|
|
12
|
+
this.workspaceSlug = (config?.workspaceSlug || process.env.KLORITY_WORKSPACE || "").trim();
|
|
13
|
+
if (!this.apiToken) {
|
|
14
|
+
console.error("[Klority MCP] WARNING: KLORITY_API_TOKEN is not configured.");
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
async request(endpoint, options = {}) {
|
|
18
|
+
const url = `${this.apiUrl}${endpoint.startsWith("/") ? "" : "/"}${endpoint}`;
|
|
19
|
+
const headers = {
|
|
20
|
+
"Authorization": `Bearer ${this.apiToken}`,
|
|
21
|
+
"Content-Type": "application/json",
|
|
22
|
+
"x-tenant-id": this.workspaceSlug,
|
|
23
|
+
"x-mcp-client": "@klority/mcp-server",
|
|
24
|
+
...(options.headers || {})
|
|
25
|
+
};
|
|
26
|
+
const res = await fetch(url, {
|
|
27
|
+
...options,
|
|
28
|
+
headers
|
|
29
|
+
});
|
|
30
|
+
if (!res.ok) {
|
|
31
|
+
let errDetails = "";
|
|
32
|
+
try {
|
|
33
|
+
const errJson = await res.json();
|
|
34
|
+
errDetails = errJson.message || errJson.error || JSON.stringify(errJson);
|
|
35
|
+
}
|
|
36
|
+
catch {
|
|
37
|
+
errDetails = await res.text();
|
|
38
|
+
}
|
|
39
|
+
throw new Error(`Klority API request failed (${res.status} ${res.statusText}): ${errDetails}`);
|
|
40
|
+
}
|
|
41
|
+
return res.json();
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Verify token and workspace connection
|
|
45
|
+
*/
|
|
46
|
+
async verifyAuth() {
|
|
47
|
+
return this.request("/ide/auth/verify");
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* Search tasks with optional filters
|
|
51
|
+
*/
|
|
52
|
+
async searchTasks(params) {
|
|
53
|
+
const qs = new URLSearchParams();
|
|
54
|
+
if (params.projectId)
|
|
55
|
+
qs.set("projectId", params.projectId);
|
|
56
|
+
if (params.sprintId)
|
|
57
|
+
qs.set("sprintId", params.sprintId);
|
|
58
|
+
if (params.since)
|
|
59
|
+
qs.set("since", params.since);
|
|
60
|
+
if (params.query)
|
|
61
|
+
qs.set("query", params.query);
|
|
62
|
+
if (params.limit)
|
|
63
|
+
qs.set("limit", String(params.limit));
|
|
64
|
+
const endpoint = `/ide/tasks${qs.toString() ? `?${qs.toString()}` : ""}`;
|
|
65
|
+
return this.request(endpoint);
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* Get specific task by UUID or custom key (e.g. KLOR-104)
|
|
69
|
+
*/
|
|
70
|
+
async getTask(taskId) {
|
|
71
|
+
return this.request(`/ide/tasks/${encodeURIComponent(taskId)}`);
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
* Create a new task/story/bug
|
|
75
|
+
*/
|
|
76
|
+
async createTask(data) {
|
|
77
|
+
return this.request("/ide/tasks", {
|
|
78
|
+
method: "POST",
|
|
79
|
+
body: JSON.stringify(data)
|
|
80
|
+
});
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* Update task status (column) and optionally leave a comment
|
|
84
|
+
*/
|
|
85
|
+
async updateTaskStatus(taskId, columnId, comment) {
|
|
86
|
+
return this.request(`/ide/tasks/${encodeURIComponent(taskId)}/status`, {
|
|
87
|
+
method: "PATCH",
|
|
88
|
+
body: JSON.stringify({ columnId, comment })
|
|
89
|
+
});
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* Post a comment to a task
|
|
93
|
+
*/
|
|
94
|
+
async addTaskComment(taskId, content) {
|
|
95
|
+
return this.request(`/ide/tasks/${encodeURIComponent(taskId)}/comments`, {
|
|
96
|
+
method: "POST",
|
|
97
|
+
body: JSON.stringify({ content })
|
|
98
|
+
});
|
|
99
|
+
}
|
|
100
|
+
/**
|
|
101
|
+
* List sprints in a project
|
|
102
|
+
*/
|
|
103
|
+
async listSprints(projectId, state) {
|
|
104
|
+
const qs = new URLSearchParams({ projectId });
|
|
105
|
+
if (state)
|
|
106
|
+
qs.set("state", state);
|
|
107
|
+
return this.request(`/ide/sprints?${qs.toString()}`);
|
|
108
|
+
}
|
|
109
|
+
/**
|
|
110
|
+
* Search wiki documentation and PRDs
|
|
111
|
+
*/
|
|
112
|
+
async searchPages(params) {
|
|
113
|
+
const qs = new URLSearchParams();
|
|
114
|
+
if (params.projectId)
|
|
115
|
+
qs.set("projectId", params.projectId);
|
|
116
|
+
if (params.query)
|
|
117
|
+
qs.set("query", params.query);
|
|
118
|
+
if (params.since)
|
|
119
|
+
qs.set("since", params.since);
|
|
120
|
+
const endpoint = `/ide/pages${qs.toString() ? `?${qs.toString()}` : ""}`;
|
|
121
|
+
return this.request(endpoint);
|
|
122
|
+
}
|
|
123
|
+
/**
|
|
124
|
+
* Get wiki page content by ID
|
|
125
|
+
*/
|
|
126
|
+
async getPage(pageId) {
|
|
127
|
+
return this.request(`/ide/pages/${encodeURIComponent(pageId)}`);
|
|
128
|
+
}
|
|
129
|
+
/**
|
|
130
|
+
* Create or update a wiki page
|
|
131
|
+
*/
|
|
132
|
+
async createOrUpdatePage(data) {
|
|
133
|
+
return this.request("/ide/pages", {
|
|
134
|
+
method: "POST",
|
|
135
|
+
body: JSON.stringify(data)
|
|
136
|
+
});
|
|
137
|
+
}
|
|
138
|
+
/**
|
|
139
|
+
* Fetch QA test cases / acceptance criteria
|
|
140
|
+
*/
|
|
141
|
+
async getQACriteria(params) {
|
|
142
|
+
const qs = new URLSearchParams();
|
|
143
|
+
if (params.projectId)
|
|
144
|
+
qs.set("projectId", params.projectId);
|
|
145
|
+
if (params.query)
|
|
146
|
+
qs.set("query", params.query);
|
|
147
|
+
if (params.since)
|
|
148
|
+
qs.set("since", params.since);
|
|
149
|
+
const endpoint = `/ide/qa${qs.toString() ? `?${qs.toString()}` : ""}`;
|
|
150
|
+
return this.request(endpoint);
|
|
151
|
+
}
|
|
152
|
+
/**
|
|
153
|
+
* Create a new test case
|
|
154
|
+
*/
|
|
155
|
+
async createTestCase(data) {
|
|
156
|
+
return this.request("/ide/qa/test-cases", {
|
|
157
|
+
method: "POST",
|
|
158
|
+
body: JSON.stringify(data)
|
|
159
|
+
});
|
|
160
|
+
}
|
|
161
|
+
/**
|
|
162
|
+
* Ingest test run results (e.g. from Playwright, Jest, Vitest)
|
|
163
|
+
*/
|
|
164
|
+
async recordTestRuns(data) {
|
|
165
|
+
return this.request("/ide/qa/runs", {
|
|
166
|
+
method: "POST",
|
|
167
|
+
body: JSON.stringify(data)
|
|
168
|
+
});
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* Search CRM deals, companies, contacts
|
|
172
|
+
*/
|
|
173
|
+
async searchCRM(query, entity) {
|
|
174
|
+
const qs = new URLSearchParams({ query });
|
|
175
|
+
if (entity)
|
|
176
|
+
qs.set("entity", entity);
|
|
177
|
+
return this.request(`/ide/crm?${qs.toString()}`);
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
//# sourceMappingURL=client.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* Official Klority Model Context Protocol (MCP) Server
|
|
4
|
+
* Enables AI coding assistants (Cursor, Claude Desktop, Claude Code, Cline, Windsurf)
|
|
5
|
+
* to interact with Klority Tasks, Wiki PRDs, Test Management, and CRM.
|
|
6
|
+
*/
|
|
7
|
+
export {};
|
|
8
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* Official Klority Model Context Protocol (MCP) Server
|
|
4
|
+
* Enables AI coding assistants (Cursor, Claude Desktop, Claude Code, Cline, Windsurf)
|
|
5
|
+
* to interact with Klority Tasks, Wiki PRDs, Test Management, and CRM.
|
|
6
|
+
*/
|
|
7
|
+
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
8
|
+
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
|
|
9
|
+
import { KlorityClient } from "./client.js";
|
|
10
|
+
import { registerTaskTools } from "./tools/tasks.js";
|
|
11
|
+
import { registerWikiTools } from "./tools/wiki.js";
|
|
12
|
+
import { registerQATools } from "./tools/qa.js";
|
|
13
|
+
import { registerCRMTools } from "./tools/crm.js";
|
|
14
|
+
import { registerResources } from "./resources/index.js";
|
|
15
|
+
import { registerPrompts } from "./prompts/index.js";
|
|
16
|
+
// Parse basic command-line flags if provided
|
|
17
|
+
const args = process.argv.slice(2);
|
|
18
|
+
function getArg(flag) {
|
|
19
|
+
const index = args.indexOf(flag);
|
|
20
|
+
if (index !== -1 && index + 1 < args.length) {
|
|
21
|
+
return args[index + 1];
|
|
22
|
+
}
|
|
23
|
+
return undefined;
|
|
24
|
+
}
|
|
25
|
+
const apiUrl = getArg("--url") || process.env.KLORITY_API_URL || "https://app.klority.com/api";
|
|
26
|
+
const apiToken = getArg("--token") || process.env.KLORITY_API_TOKEN || "";
|
|
27
|
+
const workspaceSlug = getArg("--workspace") || process.env.KLORITY_WORKSPACE || "";
|
|
28
|
+
// Output diagnostics ONLY to stderr (stdout is strictly reserved for MCP JSON-RPC protocol)
|
|
29
|
+
console.error(`[Klority MCP] Initializing Klority MCP Server v1.0.0...`);
|
|
30
|
+
console.error(`[Klority MCP] Target API: ${apiUrl}`);
|
|
31
|
+
console.error(`[Klority MCP] Workspace: ${workspaceSlug || "(from token default)"}`);
|
|
32
|
+
if (!apiToken) {
|
|
33
|
+
console.error(`[Klority MCP] WARNING: KLORITY_API_TOKEN is not set. Tools requiring authentication will fail.`);
|
|
34
|
+
console.error(`[Klority MCP] Generate a Personal Access Token in Klority Web App -> Settings -> Model Context Protocol.`);
|
|
35
|
+
}
|
|
36
|
+
// 1. Initialize Klority API Client
|
|
37
|
+
const client = new KlorityClient({
|
|
38
|
+
apiUrl,
|
|
39
|
+
apiToken,
|
|
40
|
+
workspaceSlug
|
|
41
|
+
});
|
|
42
|
+
// 2. Initialize MCP Server
|
|
43
|
+
const server = new McpServer({
|
|
44
|
+
name: "klority",
|
|
45
|
+
version: "1.0.0"
|
|
46
|
+
}, {
|
|
47
|
+
capabilities: {
|
|
48
|
+
tools: {},
|
|
49
|
+
resources: {},
|
|
50
|
+
prompts: {}
|
|
51
|
+
}
|
|
52
|
+
});
|
|
53
|
+
// 3. Register All Primitives
|
|
54
|
+
registerTaskTools(server, client);
|
|
55
|
+
registerWikiTools(server, client);
|
|
56
|
+
registerQATools(server, client);
|
|
57
|
+
registerCRMTools(server, client);
|
|
58
|
+
registerResources(server, client);
|
|
59
|
+
registerPrompts(server, client);
|
|
60
|
+
// 4. Start Server with Stdio Transport
|
|
61
|
+
async function main() {
|
|
62
|
+
const transport = new StdioServerTransport();
|
|
63
|
+
await server.connect(transport);
|
|
64
|
+
console.error(`[Klority MCP] Server connected to Stdio transport. Ready for client requests.`);
|
|
65
|
+
}
|
|
66
|
+
main().catch((err) => {
|
|
67
|
+
console.error(`[Klority MCP] Fatal error starting server:`, err);
|
|
68
|
+
process.exit(1);
|
|
69
|
+
});
|
|
70
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,6CAA6C;AAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,SAAS,MAAM,CAAC,IAAY;IAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,6BAA6B,CAAC;AAC/F,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC;AAC1E,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC;AAEnF,4FAA4F;AAC5F,OAAO,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;AACzE,OAAO,CAAC,KAAK,CAAC,6BAA6B,MAAM,EAAE,CAAC,CAAC;AACrD,OAAO,CAAC,KAAK,CAAC,4BAA4B,aAAa,IAAI,sBAAsB,EAAE,CAAC,CAAC;AAErF,IAAI,CAAC,QAAQ,EAAE,CAAC;IACd,OAAO,CAAC,KAAK,CAAC,gGAAgG,CAAC,CAAC;IAChH,OAAO,CAAC,KAAK,CAAC,0GAA0G,CAAC,CAAC;AAC5H,CAAC;AAED,mCAAmC;AACnC,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC;IAC/B,MAAM;IACN,QAAQ;IACR,aAAa;CACd,CAAC,CAAC;AAEH,2BAA2B;AAC3B,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;IACE,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,EAAE;QACb,OAAO,EAAE,EAAE;KACZ;CACF,CACF,CAAC;AAEF,6BAA6B;AAC7B,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAClC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAClC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAChC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACjC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAClC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEhC,uCAAuC;AACvC,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,+EAA+E,CAAC,CAAC;AACjG,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,QA+GvE"}
|