@taiga-ui/mcp 0.1.0-alpha.1 → 0.1.0-alpha.3
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 +59 -29
- package/dist/utils/list-components.js +2 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,14 +1,31 @@
|
|
|
1
|
-
|
|
1
|
+
## Taiga UI MCP Server
|
|
2
|
+
|
|
3
|
+
[](https://lobehub.com/mcp/taiga-family-taiga-ui-mcp)
|
|
4
|
+
[](https://npmjs.com/package/@taiga-ui/mcp)
|
|
5
|
+
|
|
6
|
+
> 🚧 **Alpha Release**
|
|
7
|
+
> `@taiga-ui/mcp` is currently in **alpha**.
|
|
2
8
|
|
|
3
9
|
> **🚀 The fastest way to integrate Taiga UI components into your AI workflow**
|
|
4
10
|
|
|
5
11
|
A Model Context Protocol (MCP) server that provides AI assistants with comprehensive access to [Taiga UI](https://taiga-ui.dev) components. Seamlessly retrieve Taiga UI components implementations for your AI-powered development workflow.
|
|
6
12
|
|
|
7
|
-
|
|
13
|
+
### Key Features
|
|
14
|
+
|
|
15
|
+
* **Docs + code snippets**. Full Taiga UI markdown plus ready Angular examples in one place.
|
|
16
|
+
* **Two MCP tools**. Discover with `get_list_components`, fetch examples via `get_component_example`.
|
|
17
|
+
* **Configurable & lightweight**. Swap source URL (stable/next) without local Angular install.
|
|
18
|
+
|
|
19
|
+
### Requirements
|
|
8
20
|
|
|
9
|
-
|
|
21
|
+
- Node.js 18 or newer
|
|
22
|
+
- VS Code, Cursor, Windsurf, Claude Desktop, Goose or any other MCP client
|
|
10
23
|
|
|
11
|
-
|
|
24
|
+
### Getting started
|
|
25
|
+
|
|
26
|
+
First, install the Taiga UI MCP server with your client.
|
|
27
|
+
|
|
28
|
+
**Standard config** works in most of the tools:
|
|
12
29
|
|
|
13
30
|
```json
|
|
14
31
|
{
|
|
@@ -16,7 +33,7 @@ To configure MCP in VS Code with GitHub Copilot, add the taiga-ui server to your
|
|
|
16
33
|
"taiga-ui": {
|
|
17
34
|
"command": "npx",
|
|
18
35
|
"args": [
|
|
19
|
-
"@taiga-ui/mcp@latest",
|
|
36
|
+
"@taiga-ui/mcp@latest", // now @taiga-ui/mcp@alpha to fetch most actual version
|
|
20
37
|
"--source-url=https://taiga-ui.dev/llms-full.txt" // or file from "/next" version, if you want
|
|
21
38
|
]
|
|
22
39
|
}
|
|
@@ -24,46 +41,59 @@ To configure MCP in VS Code with GitHub Copilot, add the taiga-ui server to your
|
|
|
24
41
|
}
|
|
25
42
|
```
|
|
26
43
|
|
|
27
|
-
|
|
44
|
+
### Tools
|
|
45
|
+
|
|
46
|
+
<details>
|
|
47
|
+
<summary><b>Core automation</b></summary>
|
|
28
48
|
|
|
29
49
|
1. `get_list_components { query?: string }`
|
|
30
50
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
51
|
+
- Lists component / section identifiers (with fuzzy substring filtering) along with basic metadata (category, package, type).
|
|
52
|
+
- Input: optional `query` string to filter IDs (case-insensitive substring).
|
|
53
|
+
- Output: strictly structured JSON containing `items`, `total`, `query`.
|
|
34
54
|
|
|
35
|
-
```
|
|
55
|
+
```json
|
|
36
56
|
{
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
57
|
+
"items": [
|
|
58
|
+
{ "id": "components/Alert", "name": "Alert", "category": "components", "package": "CORE", "type": "component" }
|
|
59
|
+
],
|
|
60
|
+
"total": 1,
|
|
61
|
+
"query": null
|
|
42
62
|
}
|
|
43
63
|
```
|
|
44
64
|
|
|
45
65
|
2. `get_component_example { "names": ["...", "..."] }`
|
|
46
66
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
67
|
+
- Returns full markdown content for each resolved section (entire component documentation).
|
|
68
|
+
- Fuzzy name resolution: exact match, path segment, suffix, substring, and `Tui*` variants.
|
|
69
|
+
- Input: `{ names: string[] }` (each name length ≥ 2).
|
|
70
|
+
- Output: `results` array with objects: `query`, `id` (if resolved), `package`, `type`, `suggestions` (only when unresolved), `content` (array of code blocks, if examples exist). Top-level also includes `matched` (count of resolved names).
|
|
50
71
|
|
|
51
|
-
```
|
|
72
|
+
```json
|
|
52
73
|
{
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
74
|
+
"results": [
|
|
75
|
+
{
|
|
76
|
+
"query": "Alert",
|
|
77
|
+
"id": "components/Alert",
|
|
78
|
+
"package": "CORE",
|
|
79
|
+
"type": "component",
|
|
80
|
+
"content": ["# components/Alert\n- **Package**: ... (full section markdown here)"]
|
|
81
|
+
}
|
|
82
|
+
],
|
|
62
83
|
"matched": 1
|
|
63
84
|
}
|
|
64
85
|
```
|
|
65
86
|
|
|
66
|
-
|
|
87
|
+
> Tip: Combine `get_list_components` to discover IDs and then fetch full implementation snippets with `get_component_example`.
|
|
88
|
+
|
|
89
|
+
</details>
|
|
90
|
+
|
|
91
|
+
### Maintained
|
|
92
|
+
|
|
93
|
+
Taiga UI MCP is a part of [Taiga UI](https://github.com/taiga-family/taiga-ui) libraries family which is backed and used by a
|
|
94
|
+
large enterprise. This means you can rely on timely support and continuous development.
|
|
95
|
+
|
|
96
|
+
### Authors
|
|
67
97
|
|
|
68
98
|
<table>
|
|
69
99
|
<tr>
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { state } from '../server/server.js';
|
|
2
|
-
export function constructComponentsList(query) {
|
|
3
|
-
const normalizedQuery = query
|
|
2
|
+
export function constructComponentsList(query = '') {
|
|
3
|
+
const normalizedQuery = query?.toLowerCase().replace(/^tui/, '');
|
|
4
4
|
const items = state.sections
|
|
5
5
|
.filter((section) => !normalizedQuery ||
|
|
6
6
|
section.id.toLowerCase().includes(normalizedQuery))
|
package/package.json
CHANGED