Harper

Harper

An MCP server providing an interface for MCP clients to access data within Harper.

15
Stars
0
Forks
0
Releases

Overview

This MCP server provides a protocol-compliant gateway to HarperDB, exposing data as standardized Resources accessible through JSON-RPC calls. It implements the MCP methods resources/list and resources/read via a single /mcp endpoint and uses JSON-RPC 2.0 for all requests and responses. The server sources data from HarperDB tables and custom resources, presenting each as a Resource with a URI, name, and description, and supports filtering with query parameters (attribute=value) and equals comparison. It also supports pagination through limit and start to control result sets. A static capabilities endpoint at /capabilities.json enumerates predefined capabilities. The API is designed for read-only access to Harper data and supports security via HarperDB’s authentication mechanisms (Basic, JWT, mTLS). Accessibility is constructed using URIs of the form {HOST}/{table_name} for tables and {HOST}/{path}/{resource_name} for custom resources. The Harper MCP server is deployed via Harper’s npm package and Operation API, with deployment examples shown in the README.

Details

Owner
HarperDB
Language
TypeScript
License
Apache License 2.0
Updated
2025-12-07

Features

MCP-compatible API server for Harper

Implements MCP methods and exposes data as resources via a single /mcp endpoint using JSON-RPC 2.0.

Predefined capabilities endpoint

Serves a static /capabilities.json with predefined capabilities for MCP clients.

Read-only data access

Provides read-only access to HarperDB tables and custom resources.

Query parameter filtering

Supports filtering Harper table data using query parameters (attribute=value) with an equals comparator.

Pagination support

Handles pagination via limit and start for table data retrieval.

Standardized error handling

Returns JSON-RPC 2.0 error responses with standard error codes (-32601, -32602, -32603).

Audience

MCP clientsAccess HarperDB data as Resources via JSON-RPC using the Harper MCP server.

Tags

MCPHarperDBJSON-RPCResourcesTablesCustom ResourcesRead-onlyPaginationQuery FilteringCapabilities EndpointSecurity