open-index/open-npm huggingface dataset:
npm package: @skyscraper083/knowledge-mcp-server
Description: MCP stdio server (npx) that bridges to MindHorizon knowledge search HTTP API
Latest version: 0.2.0

# @skyscraper083/knowledge-mcp-server

An MCP **stdio** server intended for non-technical end users.

It runs locally via `npx`, and forwards tool calls to a MindHorizon backend HTTP endpoint.

## Environment variables

- `BASE_URL`: backend base URL (default: `http://localhost:8000`)
- `MCP_USER_NAME`: username (maps to `public.user_profiles.username`)
- `MCP_ACCESS_KEY`: access key (maps to `public.user_profiles.access_key`)

## Publishing (maintainers)

This package is intended to be consumed via `npx`, so it must be published to npm.

```bash
cd packages/yazuishou-knowledge-mcp-server
npm login
npm publish
```

Verify:

```bash
npm view @skyscraper083/knowledge-mcp-server version
npx -y @skyscraper083/knowledge-mcp-server --help
```

## Claude Desktop config example

```toml
type = "stdio"
command = "npx"
args = ["-y", "@skyscraper083/knowledge-mcp-server", "--stdio"]

[env]
BASE_URL = "https://YOUR_BACKEND_HOST"
MCP_USER_NAME = "{your user name}"
MCP_ACCESS_KEY = "{your access key}"
```

## Tool

- `search_knowledge_with_images(project_name, query, max_text_results=5, max_image_results=3) -> str`
  - Returns a JSON string:
    - `text_results`: list of `{ content, metadata, type: "text" }`
    - `image_results`: list of image dicts including `image_url`
    - `total_text`, `total_images`