tailwindcss-docs-mcp 1.0.0 → 1.0.2

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 CHANGED
@@ -49,9 +49,9 @@ Add to your project's `.mcp.json`:
49
49
 
50
50
  ### First run
51
51
 
52
- On first boot the embedding model (~27 MB) downloads in the background. The server is usable immediately — tools that need embeddings will return a status message until the model is ready. Use `check_status` to verify.
52
+ On first boot the embedding model (~27 MB) downloads in the background. The server is usable immediately — tools that need embeddings will return a status message until the model is ready.
53
53
 
54
- Then ask your assistant: _"Fetch the Tailwind CSS docs"_ this downloads and indexes the documentation. You only need to do this once.
54
+ The first time you ask a Tailwind question, your assistant will automatically call `fetch_docs` to download and index the documentation. This happens once subsequent queries use the local index.
55
55
 
56
56
  ### Example prompts
57
57
 
package/dist/server.js CHANGED
@@ -52,7 +52,7 @@ export async function createServer(deps, transport) {
52
52
  });
53
53
  // Register fetch_docs
54
54
  server.tool(TOOL_NAMES.FETCH_DOCS, "Download and index Tailwind CSS documentation for local semantic search. Only needs to be run once per version. Re-run with force=true to refresh.", {
55
- version: z.enum(["v3", "v4"]).optional().describe("Tailwind CSS major version (default: v4)"),
55
+ version: z.enum(["v4", "v3"]).optional().describe("Tailwind CSS major version (default: v4)"),
56
56
  force: z
57
57
  .boolean()
58
58
  .optional()
@@ -97,7 +97,7 @@ export async function createServer(deps, transport) {
97
97
  .string()
98
98
  .optional()
99
99
  .describe("Filter by category (e.g., 'Layout', 'Spacing', 'Typography', 'Flexbox & Grid'). Omit to list all categories."),
100
- version: z.enum(["v3", "v4"]).optional().describe("Tailwind CSS major version (default: v4)"),
100
+ version: z.enum(["v4", "v3"]).optional().describe("Tailwind CSS major version (default: v4)"),
101
101
  }, (params) => {
102
102
  try {
103
103
  const result = handleListUtilities(params, db, config.defaultVersion);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "tailwindcss-docs-mcp",
3
- "version": "1.0.0",
3
+ "version": "1.0.2",
4
4
  "type": "module",
5
5
  "description": "Local semantic search for Tailwind CSS documentation via Model Context Protocol",
6
6
  "license": "MIT",
@@ -1,21 +0,0 @@
1
- import type { Embedder } from "./pipeline/embedder.js";
2
- import type { Database } from "./storage/database.js";
3
- import type { Config } from "./utils/config.js";
4
- /**
5
- * Callbacks for auto-index lifecycle events.
6
- */
7
- export interface AutoIndexCallbacks {
8
- onStart: () => void;
9
- onComplete: () => void;
10
- onError: (error: unknown) => void;
11
- }
12
- /**
13
- * Auto-index the default Tailwind CSS version if not already indexed.
14
- *
15
- * Checks the database for an existing index. If found, calls onComplete
16
- * immediately. Otherwise, triggers handleFetchDocs in the background.
17
- *
18
- * Reuses handleFetchDocs which has its own mutex for concurrent-call safety.
19
- */
20
- export declare function maybeAutoIndex(config: Config, db: Database, embedder: Embedder, callbacks: AutoIndexCallbacks): Promise<void>;
21
- //# sourceMappingURL=auto-index.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"auto-index.d.ts","sourceRoot":"","sources":["../src/auto-index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,kBAAkB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAkBf"}
@@ -1,27 +0,0 @@
1
- import { handleFetchDocs } from "./tools/fetch-docs.js";
2
- /**
3
- * Auto-index the default Tailwind CSS version if not already indexed.
4
- *
5
- * Checks the database for an existing index. If found, calls onComplete
6
- * immediately. Otherwise, triggers handleFetchDocs in the background.
7
- *
8
- * Reuses handleFetchDocs which has its own mutex for concurrent-call safety.
9
- */
10
- export async function maybeAutoIndex(config, db, embedder, callbacks) {
11
- const version = config.defaultVersion;
12
- // Skip if already indexed
13
- const status = db.getIndexStatus(version);
14
- if (status.length > 0) {
15
- callbacks.onComplete();
16
- return;
17
- }
18
- callbacks.onStart();
19
- try {
20
- await handleFetchDocs({ version }, config, db, embedder);
21
- callbacks.onComplete();
22
- }
23
- catch (error) {
24
- callbacks.onError(error);
25
- }
26
- }
27
- //# sourceMappingURL=auto-index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"auto-index.js","sourceRoot":"","sources":["../src/auto-index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAYxD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,EAAY,EACZ,QAAkB,EAClB,SAA6B;IAE7B,MAAM,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC;IAEtC,0BAA0B;IAC1B,MAAM,MAAM,GAAG,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,SAAS,CAAC,UAAU,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IAED,SAAS,CAAC,OAAO,EAAE,CAAC;IAEpB,IAAI,CAAC;QACH,MAAM,eAAe,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;QACzD,SAAS,CAAC,UAAU,EAAE,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC"}