jetbrains-psi-mcp-server/README.md

JetBrains PSI MCP Server (JavaScript) — bridges MCP tools to IntelliJ/Android Studio plugin.

JetBrains PSI MCP Server (TypeScript)

Overview
- JavaScript MCP server that proxies MCP tool calls to the IntelliJ/Android Studio plugin HTTP API (e.g., http://localhost:8081).
- Replaces the previous Kotlin-based MCP server distribution for easier install via npm.
- For local development, runs via tsx (no build step required); for distribution, use the built dist/ entry.

Prerequisites
- Node.js 20+

Install (local dev)
```
cd js-server
npm install
```

Run (connect to plugin on 8081 by default)
```
npx tsx src/index.ts
# or specify port
npx tsx src/index.ts 8081
# or via env var
PLUGIN_PORT=8081 npx tsx src/index.ts
# health check without starting MCP server
npx tsx src/index.ts health 8081
```

Publish as CLI (optional)
- Add a proper build or keep tsx runtime dependency.
- Example bin usage after local install:
```
npm link
jetbrains-psi-mcp 8081
# health check
jetbrains-psi-mcp health 8081
```

NPM usage (after publish)
```
npx jetbrains-psi-mcp-server 8081
# or install globally
npm i -g jetbrains-psi-mcp-server
jetbrains-psi-mcp 8081
```

Release via GitHub Action
- Tag with `server-vX.Y.Z` (stable) or `server-vX.Y.Z-rc.1` (prerelease)
```
git tag server-v1.0.3
git push origin server-v1.0.3
```
- Action builds `dist/` and publishes to npm with dist-tag `latest` (or `next` for prereleases)

Notes
- Tools and schemas mirror the Kotlin implementation.
- Health check ensures the plugin is up before forwarding.