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.