@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 HTTP client 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 just waits for a client. Use an MCP client (Claude Code, the MCP Inspector, etc.) to interact with it.

Publish

npm login
npm publish --access public