@kotoragk/hp-mcp
A sample MCP (Model Context Protocol) server that exposes the kotoragk HP(homepage) public API as read-only tools. It is intentionally small: a thin HTTPclient that fetches the existing HP endpoints and returns the JSON to the model.
Use it as a reference for how to build and publish an MCP server in TypeScript.
Tools
| Tool | Arguments | Description |
|---|---|---|
get_news |
page? (number) |
News (お知らせ) list with count and categories |
get_news_detail |
newsnumber (number) |
A single news article, with prev/next links |
get_company |
— | Company (会社情報) profile |
Each tool calls ${HP_API_BASE_URL}/hp/... and returns the raw JSON.
Install into Claude Code
claude mcp add hp -- npx -y @kotoragk/hp-mcp
To point at a different backend (e.g. a local Django server), pass the env var:
claude mcp add hp -e HP_API_BASE_URL=http://127.0.0.1:8000 -- npx -y @kotoragk/hp-mcp
| Env var | Default | Description |
|---|---|---|
HP_API_BASE_URL |
https://kotoragk.com |
Base URL of the HP API (no trailing /hp) |
Local development
npm install
npm run build # compiles src/ -> dist/
npm start # runs dist/index.js on stdio
The server speaks the MCP protocol over stdio, so running it directly justwaits for a client. Use an MCP client (Claude Code, the MCP Inspector, etc.) tointeract with it.
Publish
npm login
npm publish --access public
