Harden and polish: tests, CI, lint, publish metadata, docs

.github/workflows/ci.yml

@@ -0,0 +1,24 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [20, 22]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+      - run: npm ci
+      - run: npx biome ci .
+      - run: npm run typecheck
+      - run: npm run build
+      - run: npm test

CLAUDE.md

@@ -0,0 +1,23 @@
+# CLAUDE.md
+
+## Commands
+
+- `npm run build` — compile TypeScript to `dist/`
+- `npm run typecheck` — `tsc --noEmit`
+- `npm run check` / `npm run fix` — Biome lint + format (check / write)
+- `npm test` / `npm run test:watch` — vitest
+- `npm run dev` — `tsc --watch`
+
+## Architecture
+
+Stdio MCP server for the Tembo API. `src/index.ts` is the thin bin entry point
+(env parsing, client construction, stdio connect). `src/server.ts` exports
+`createServer(tembo)` which registers the five tools against an injected client
+satisfying the structural `TemboApi` interface. `src/client.ts` wraps
+`@tembo-io/sdk`. Tests in `tests/` drive the server over the MCP SDK's
+`InMemoryTransport` with a plain-object mock client — no network, no real key.
+
+## Notes
+
+- ESM with Node16 module resolution: relative imports need `.js` extensions.
+- The server version is read from `package.json` at runtime; don't hardcode it.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Tembo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -30,6 +30,8 @@ npx -y @tembo-io/mcp
 npm install -g @tembo-io/mcp
 ```
 
+A global install exposes the binary as `tembo-mcp`.
+
 ## Usage
 
 ### 1. Get an API Key
@@ -38,7 +40,15 @@ Head to the [API Keys page](https://app.tembo.io/settings/api-keys) and obtain a
 
 ### 2. Configure Your MCP Client
 
-Add the following configuration to your MCP client settings (e.g., Claude Desktop's `claude_desktop_config.json`):
+#### Claude Code
+
+```bash
+claude mcp add tembo -e TEMBO_API_KEY=your-api-key -- npx -y @tembo-io/mcp
+```
+
+#### Claude Desktop
+
+Add the following to `claude_desktop_config.json`:
 
 ```json
 {
@@ -52,4 +62,54 @@ Add the following configuration to your MCP client settings (e.g., Claude Deskto
     }
   }
 }
-```
+```
+
+### Environment Variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `TEMBO_API_KEY` | Yes | Your Tembo API key |
+| `TEMBO_API_URL` | No | Tembo API base URL (default `https://api.tembo.io`) |
+
+## Tools
+
+### create_task
+
+| Parameter | Type | Required | Description |
+|---|---|---|---|
+| `prompt` | string | One of `prompt`/`description` | Description of the task to be performed |
+| `description` | string | — | Deprecated alias for `prompt` |
+| `repositories` | string[] | No | Code repository URLs the task relates to |
+| `branch` | string | No | Specific git branch to target |
+| `agent` | string | No | Agent to use (e.g. `claudeCode:claude-4-5-sonnet`) |
+| `queueRightAway` | boolean | No (default `true`) | Queue the task for processing immediately |
+
+### list_tasks / search_tasks
+
+Both accept `limit` (1-100, default 10) and `page` (default 1); `search_tasks` also requires `q`, the search query.
+
+### list_repositories / get_current_user
+
+No parameters.
+
+## Development
+
+```bash
+git clone https://github.com/tembo/mcp.git
+cd mcp
+npm install
+npm run build      # compile to dist/
+npm test           # run the vitest suite
+npm run check      # lint + format check (Biome)
+npm run typecheck  # tsc --noEmit
+```
+
+Smoke-test the built server without a real API key:
+
+```bash
+TEMBO_API_KEY=test npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list
+```
+
+## License
+
+[MIT](LICENSE)

biome.json

@@ -0,0 +1,36 @@
+{
+    "$schema": "https://biomejs.dev/schemas/2.5.3/schema.json",
+    "vcs": {
+        "enabled": true,
+        "clientKind": "git",
+        "useIgnoreFile": true
+    },
+    "files": {
+        "includes": ["**", "!!**/dist"]
+    },
+    "formatter": {
+        "enabled": true,
+        "indentStyle": "space",
+        "indentWidth": 4,
+        "lineWidth": 100
+    },
+    "linter": {
+        "enabled": true,
+        "rules": {
+            "preset": "recommended"
+        }
+    },
+    "javascript": {
+        "formatter": {
+            "quoteStyle": "single"
+        }
+    },
+    "assist": {
+        "enabled": true,
+        "actions": {
+            "source": {
+                "organizeImports": "on"
+            }
+        }
+    }
+}