@hasoftware/mcp

MCP proxy for HASoftware Knowledge Base — connect Claude Code to your knowledge kits at mcp.hasoftware.vn.

Quick Start

npx @hasoftware/mcp --install

This will interactively configure Claude Code to connect to your MCP server.

Commands

| Command | Description | |---------|-------------| | npx @hasoftware/mcp | Start MCP proxy (used automatically by Claude Code) | | npx @hasoftware/mcp --install | Add MCP config to Claude Code (interactive) | | npx @hasoftware/mcp --uninstall | Remove MCP config from Claude Code | | npx @hasoftware/mcp --catalog | Browse knowledge kits by category | | npx @hasoftware/mcp --test | Test connection to MCP server | | npx @hasoftware/mcp --info | Show available tools, resources & prompts | | npx @hasoftware/mcp --setup | Show manual setup instructions | | npx @hasoftware/mcp --help | Show help | | npx @hasoftware/mcp --version | Show version |

Manual Setup

1. Get your token

Log in to mcp.hasoftware.vn and copy your MCP token from the My Token page.

2. Add to Claude Code

{
  "mcpServers": {
    "hasoftware": {
      "command": "npx",
      "args": ["-y", "@hasoftware/mcp"],
      "env": {
        "HASOFTWARE_TOKEN": "your-token-here"
      }
    }
  }
}

Add this to ~/.claude/settings.json (global) or .claude/mcp.json (project).

3. Use it

You: "Search my knowledge kits for react best practices"
Claude: [calls search_kits → reads files → gives you the answer]

What You Get

| Capability | Count | Examples | |-----------|-------|---------| | Tools | 10 | search_kits, get_kit, get_file, create_kit, update_file | | Resources | 2 | knowledge://kits/{slug}, knowledge://kits/{slug}/{filename} | | Prompts | 1 | use_kit(slug) — load a kit into Claude's context |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | HASOFTWARE_TOKEN | Yes | Your MCP bearer token | | HASOFTWARE_URL | No | Custom server URL (default: https://mcp.hasoftware.vn/api/mcp) |

How It Works

This package is a lightweight stdio-to-HTTP proxy. When Claude Code starts it:

1. Connects to mcp.hasoftware.vn using your bearer token
2. Discovers available tools, resources, and prompts
3. Proxies all MCP requests between Claude Code (stdin/stdout) and the remote server (HTTP)

The proxy is ~120 lines of code. It does not store data, access files, or run any logic beyond forwarding messages.

License

MIT