PolyNeural.ai Knowledge Graph MCP Bundle

PolyNeural.ai MCP Bundle (@polyneural/mcpb)

An MCP Bundle that provides AI agents with persistent memory through the PolyNeural.ai knowledge graph platform.

🚀 Quick Download

Double-click the .mcpb file to install in Claude Desktop, then configure your PolyNeural.ai API key.

Architecture

This MCP Bundle implements a stdio MCP server that bridges to the PolyNeural.ai backend HTTP MCP endpoints. This approach provides:

✅ No code duplication - Uses existing PolyNeural.ai backend MCP endpoints
✅ Seamless authentication - Forwards API keys via HTTP headers
✅ Protocol translation - Bridges stdio MCP ↔ HTTP MCP endpoints
✅ Easy maintenance - Single source of truth for MCP tools and logic

Prerequisites

PolyNeural.ai Backend Running: The backend must be accessible (default: https://polyneural.ai)
Valid API Key: You need a PolyNeural.ai API key (format: kg_xxxxxxxx)
Node.js 16+: Required for running the extension

Installation

Option 1: As MCPB Bundle (Recommended)

Download the latest polyneural-mcpb.mcpb file from the releases page
Install using your MCPB-compatible application:
- Claude Desktop: Double-click the .mcpb file to install
- Other MCPB clients: Follow your client's installation process
Configure your PolyNeural.ai API key in the bundle settings UI

Option 2: Manual Installation

Install dependencies:

npm install

For Claude Desktop: Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "@polyneural/mcpb": {
      "command": "node",
      "args": ["/path/to/mcpb/server/index.js"],
      "env": {
        "API_URL": "https://polyneural.ai",
        "API_KEY": "kg_your_api_key_here",
        "DEBUG": "false",
        "TIMEOUT": "30"
      }
    }
  }
}

Configuration

The MCPB bundle supports these user configuration options (set via MCPB client UI or environment variables):

Variable	Description	Default	Required
`API_URL`	PolyNeural.ai backend URL	`https://polyneural.ai`	No
`API_KEY`	Your PolyNeural.ai API key	-	Yes
`DEBUG`	Enable debug logging	`false`	No
`TIMEOUT`	Request timeout in seconds	`30`	No

Available Tools

Once installed, Claude will have access to these PolyNeural.ai knowledge graph tools:

Core Operations

create_entities - Store new knowledge entities
create_relations - Create relationships between entities
search_nodes - Search the knowledge graph
open_nodes - Retrieve specific entities
read_graph - Get the complete graph structure

Advanced Operations

add_observations - Add details to existing entities
delete_entities - Remove entities
delete_relations - Remove relationships
delete_observations - Remove specific observations
get_entities_by_identifiers - Bulk entity retrieval
get_entity_relationships - Get entity connections
get_entities_by_date_range - Time-based queries
get_recent_changes - Recent activity tracking
get_trending_entities - Popular entities
get_frecency_entities - Frequency + recency ranking
search_with_frecency - Smart search with ranking

Testing

Manual Testing

# Set environment variables and run
API_URL=https://polyneural.ai API_KEY=kg_your_key DEBUG=true npm start

Create MCPB Bundle

# Install MCPB CLI (if not already installed)
npm install -g @anthropic-ai/mcpb

# Create the bundle
mcpb pack

Integration Testing

# Run the integration test script
node test-integration.js

Troubleshooting

Common Issues

Bundle won't start:

Verify the PolyNeural.ai backend is running: curl https://polyneural.ai/health
Check your API key format (must start with kg_)
Enable debug mode in the bundle configuration

No tools available in Claude:

Ensure Claude Desktop is restarted after installing the bundle
Check the logs for authentication errors
Verify the bundle was installed correctly

Connection timeouts:

Increase the TIMEOUT value
Check network connectivity to the backend
Verify the backend MCP endpoints are accessible: curl -H "Authorization: Bearer kg_your_key" https://polyneural.ai/mcp/initialize

Debug Mode

Enable debug logging to see detailed communication:

DEBUG=true npm start

This will show:

HTTP request details and responses
Authentication headers
MCP message routing
Error details

Architecture Details

MCP Client (stdio MCP client)
    ↕ (JSON-RPC over stdio)
@polyneural/mcpb MCP Server (HTTP bridge)
    ↕ (HTTP with Authorization headers)
PolyNeural.ai Backend (HTTP MCP endpoints)
    ↕ (Database operations)
Knowledge Graph Database

The MCPB server handles:

stdio MCP server implementation
HTTP requests to backend MCP endpoints
Authentication header forwarding
Request/response translation
Error handling and logging

Development

To modify this MCPB bundle:

Server Logic: Edit server/index.js (HTTP bridge implementation)
Bundle Configuration: Modify manifest.json for MCPB-specific settings
Dependencies: Update package.json as needed
Build Bundle: Run mcpb pack to create the .mcpb file

The beauty of this architecture is that all the actual MCP tool logic remains in the PolyNeural.ai backend - this bundle is purely an HTTP bridge.

MCPB Compliance

This bundle follows the MCPB specification:

✅ Valid manifest.json with manifest_version: "0.1"
✅ Backward Compatible: Also includes dxt_version: "0.1" for current Claude Desktop
✅ Proper MCP server implementation using @modelcontextprotocol/sdk
✅ User configuration via user_config field
✅ Platform compatibility declarations
✅ Proper error handling and timeout management
✅ Comprehensive tool and capability declarations

Compatibility Note

The manifest includes both manifest_version (MCPB standard) and dxt_version (current Claude Desktop requirement) to ensure compatibility with both current and future versions of MCPB-compatible applications.