{"_id":"@borissolomonia/rs-waybill-mcp","_rev":"2-ac8d3b923aeb35b08be9186cc5197ccf","name":"@borissolomonia/rs-waybill-mcp","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@borissolomonia/rs-waybill-mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","claude","ai","rs.ge","waybill","georgia","revenue-service","soap","api"],"author":{"name":"Boris Gagua"},"license":"MIT","_id":"@borissolomonia/rs-waybill-mcp@1.0.0","maintainers":[{"name":"borissolomonia","email":"borissolomoniaphone@gmail.com"}],"homepage":"https://github.com/yourusername/WaybillMCP#readme","bugs":{"url":"https://github.com/yourusername/WaybillMCP/issues"},"bin":{"rs-waybill-mcp":"dist/index.js"},"dist":{"shasum":"30816bcceb3bcc6b10717c995ff56906d770af75","tarball":"https://registry.npmjs.org/@borissolomonia/rs-waybill-mcp/-/rs-waybill-mcp-1.0.0.tgz","fileCount":14,"integrity":"sha512-pkG18BH05oavWgF/jDIzr12sqZ0FiHfntZtsR4pXZmAnnDM4nS5/eGFDhvGZYbl25ZGPYLuVFd0UYjeGCR0hGg==","signatures":[{"sig":"MEUCIAge5Iw9GlbOvnwOI3bmkzNCKm3FlQAoqDRZd2yxuJpyAiEAxNTr3JfpGdg3EMoeNMdFzOZIGCWdycGpiyev1+GNrTo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":77073},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20.0.0"},"private":false,"scripts":{"dev":"tsc && node dist/index.js","build":"tsc","start":"node dist/index.js","watch":"tsc --watch","inspect":"mcp-inspector node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"borissolomonia","email":"borissolomoniaphone@gmail.com"},"repository":{"url":"git+https://github.com/yourusername/WaybillMCP.git","type":"git"},"_npmVersion":"11.6.0","description":"MCP Server for Georgian Revenue Service (RS.ge) Waybill System - Natural language interface for waybill management","directories":{},"_nodeVersion":"22.19.0","dependencies":{"zod":"^3.22.4","axios":"^1.6.0","dotenv":"^16.3.1","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.10.0"},"_npmOperationalInternal":{"tmp":"tmp/rs-waybill-mcp_1.0.0_1760556866212_0.34478438295089653","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@borissolomonia/rs-waybill-mcp","version":"1.0.2","description":"MCP Server for Georgian Revenue Service (RS.ge) Waybill System - Natural language interface for waybill management","main":"dist/index.js","type":"module","bin":{"rs-waybill-mcp":"dist/cli.js"},"scripts":{"build":"tsc","watch":"tsc --watch","start":"node dist/index.js","dev":"tsc && node dist/index.js","inspect":"mcp-inspector node dist/index.js","prepare-publish":"node scripts/prepare-publish.js","prepublishOnly":"npm run prepare-publish && npm run build","postinstall":"node scripts/postinstall.js"},"keywords":["mcp","model-context-protocol","claude","ai","rs.ge","waybill","georgia","revenue-service","soap","api"],"author":{"name":"Boris Gagua"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/yourusername/WaybillMCP.git"},"homepage":"https://github.com/yourusername/WaybillMCP#readme","bugs":{"url":"https://github.com/yourusername/WaybillMCP/issues"},"engines":{"node":">=20.0.0"},"private":false,"dependencies":{"@modelcontextprotocol/sdk":"^0.5.0","axios":"^1.6.0","dotenv":"^16.3.1","zod":"^3.22.4"},"devDependencies":{"@types/node":"^20.10.0","typescript":"^5.3.3"},"_id":"@borissolomonia/rs-waybill-mcp@1.0.2","types":"./dist/index.d.ts","_nodeVersion":"22.19.0","_npmVersion":"11.6.0","dist":{"integrity":"sha512-Kxgzoyzla/1ywZrLbxnam/5T885KUi9/V2B1Ce0FVh0JjLLSOsvwCASsiG5EQrb0r8LsjrdnPQyh7aV6fvjLaQ==","shasum":"a67fafd0d28268c9f224fbf9b3d300df34980c55","tarball":"https://registry.npmjs.org/@borissolomonia/rs-waybill-mcp/-/rs-waybill-mcp-1.0.2.tgz","fileCount":32,"unpackedSize":151661,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDk3AgtNbFfC91xuRZgqxQqUgT/iuRS/avonozjCWGujQIhAJfYvn68Bfh4bQT3y3SOxRzfqzdC7XFrSaqqA/fzsQIj"}]},"_npmUser":{"name":"borissolomonia","email":"borissolomoniaphone@gmail.com"},"directories":{},"maintainers":[{"name":"borissolomonia","email":"borissolomoniaphone@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/rs-waybill-mcp_1.0.2_1760615565713_0.321149204647339"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-15T19:34:26.159Z","modified":"2025-10-16T11:52:46.101Z","1.0.0":"2025-10-15T19:34:26.410Z","1.0.2":"2025-10-16T11:52:45.890Z"},"bugs":{"url":"https://github.com/yourusername/WaybillMCP/issues"},"author":{"name":"Boris Gagua"},"license":"MIT","homepage":"https://github.com/yourusername/WaybillMCP#readme","keywords":["mcp","model-context-protocol","claude","ai","rs.ge","waybill","georgia","revenue-service","soap","api"],"repository":{"type":"git","url":"git+https://github.com/yourusername/WaybillMCP.git"},"description":"MCP Server for Georgian Revenue Service (RS.ge) Waybill System - Natural language interface for waybill management","maintainers":[{"name":"borissolomonia","email":"borissolomoniaphone@gmail.com"}],"readme":"# RS.ge Waybill MCP Server\n\nA production-ready Model Context Protocol (MCP) server that lets Claude Desktop talk to the Georgian Revenue Service (RS.ge) waybill system using natural language.\n\n---\n\n## Quick Start (For End Users)\n\n**The easiest way to get started:**\n\n1. **Configure Claude Desktop** - Add the MCP server to `claude_desktop_config.json` with your RS.ge credentials\n2. **Run one command** - `npx @borissolomonia/rs-waybill-mcp setup`\n\nThat's it! The setup command will automatically:\n- Check and install Docker if needed\n- Build and start the backend container\n- Verify everything is working\n\n**📖 See [QUICK_START.md](QUICK_START.md) for detailed step-by-step instructions.**\n\n### Manual Setup (Alternative)\n\nIf you prefer to run the scripts manually:\n\n1. **Start the backend in Docker**\n   - Windows: `cd docker && start-backend-docker.bat`\n   - macOS/Linux: `cd docker && ./start-backend-docker.sh`\n   - First run only: copy `docker/.env.example` to `docker/.env` and add your RS.ge credentials\n2. **Add the MCP server to Claude Desktop config:**\n\n   ```json\n   {\n     \"mcpServers\": {\n       \"rs-waybill\": {\n         \"command\": \"npx\",\n         \"args\": [\"-y\", \"@borissolomonia/rs-waybill-mcp\"],\n         \"env\": {\n           \"BACKEND_URL\": \"http://localhost:8081\",\n           \"RS_SERVICE_USER\": \"your-username:your-tin\",\n           \"RS_SERVICE_PASSWORD\": \"your-password\"\n         }\n       }\n     }\n   }\n   ```\n\n3. **Restart Claude Desktop**\n\nClaude will auto-launch the MCP server via `npx` whenever it starts. No git clone or local build required.\n\n---\n\n## Verify Installation\n\n- `docker-compose -f docker/docker-compose-backend-only.yml ps` should show the backend container as `Up` on port `8081`.\n- `curl http://localhost:8081/actuator/health` should return `{\"status\":\"UP\"}` once the backend is ready.\n- Inside Claude Desktop ask `What custom MCP servers do I have?` and confirm `rs-waybill` appears with 16 tools.\n- Ask `Check if my RS.ge credentials are valid` to confirm everything works end-to-end.\n\n---\n\n## Available MCP Tools\n\n| Category | Tools |\n| --- | --- |\n| Lookup | `get_error_codes`, `get_akciz_codes`, `get_name_from_tin`, `get_service_users`, `check_service_user`, `get_waybill_types` |\n| Waybill queries | `get_waybill`, `get_waybills`, `get_waybills_v1`, `get_buyer_waybills` |\n| Waybill management | `save_waybill`, `send_waybill`, `close_waybill`, `confirm_waybill`, `reject_waybill` |\n| Invoices | `save_invoice` |\n\nEach tool proxies through the Spring Boot backend, which handles SOAP/XML communication with RS.ge.\n\n---\n\n## When You Launch the Backend\n\n- Run `start-backend-docker.bat` (Windows) or `./start-backend-docker.sh` (macOS/Linux) whenever you need RS.ge access.\n- Leave the terminal open; stop the backend with `docker-compose -f docker/docker-compose-backend-only.yml down` when finished.\n- Keep `RS_SERVICE_USER` and `RS_SERVICE_PASSWORD` in both `docker/.env` (for the backend) and the Claude config (for the MCP server).\n\n---\n\n## Documentation Map\n\n- **Quick Start (New Users):** `QUICK_START.md` - Get started in 2 steps!\n- **User Installation Guide:** `docs/USER_INSTALLATION_GUIDE.md` - Complete guide for end users\n- **Detailed Setup:** `docs/SETUP.md` - Manual setup instructions\n- **Troubleshooting:** `docs/TROUBLESHOOTING.md` - Common issues and solutions\n- **Architecture & Learning:** `docs/LEARNING.md` - Design decisions and how it works\n- **Docker Details:** `docker/README-DOCKER.md` - Advanced Docker usage\n- **MCP Package:** `mcp-server/README.md` - MCP server specifics\n\n---\n\n## Architecture Snapshot\n\n```\nClaude Desktop (local process)\n    ? launches `npx @borissolomonia/rs-waybill-mcp`\n        ? HTTP to backend at http://localhost:8081\n            ? Spring Boot service (Docker) ? RS.ge SOAP API\n```\n\nClaude must start the MCP server locally over STDIO, so only the backend runs in Docker. This keeps setup simple and still lets other machines use the MCP server via `npx`.\n\n---\n\n## Contributing & Support\n\n- Issues and pull requests welcome in this repository.\n- Open `docker/README-DOCKER.md` for backend-only Docker commands.\n- See `docs/LEARNING.md` for background, design rationale, and extension ideas.\n\n---\n\n## License\n\nMIT License. See `LICENSE` for details.\n","readmeFilename":"README.md"}