Skip to content

README.md

Latest commit

 

History

History
227 lines (156 loc) · 3.88 KB

README.md

File metadata and controls

227 lines (156 loc) · 3.88 KB

SerialMemory MCP Client

Official Model Context Protocol (MCP) client for the SerialMemory Cloud Platform.
Compatible with Claude Desktop, Cursor, Kilo Code, and any MCP-enabled IDE.

Release License Framework MCP Platform

🚀 Overview

The SerialMemory MCP Client is a thin, stateless proxy that forwards MCP tool calls to:

https://api.serialmemory.dev/api/mcp/tools/

It contains zero backend logic — all intelligence happens on SerialMemory Cloud.

📦 Installation

1. Download Binary

➡️ https://github.com/sblanchard/SerialMemory-MCP/releases

  • Windows: serialmemory-mcp-win-x64.zip
  • macOS ARM: serialmemory-mcp-macos-arm64.tar.gz
  • Linux: serialmemory-mcp-linux-x64.tar.gz

Extract anywhere.

⚙️ Configuration

Linux / macOS

export SERIALMEMORY_ENDPOINT="https://api.serialmemory.dev"
export SERIALMEMORY_API_KEY="your-api-key"

Windows PowerShell

setx SERIALMEMORY_ENDPOINT "https://api.serialmemory.dev"
setx SERIALMEMORY_API_KEY "your-api-key"

Get your API key from:
https://app.serialmemory.dev/dashboard

▶️ Running

Direct execution

./serialmemory-mcp

Docker

docker run -it \
  -e SERIALMEMORY_ENDPOINT="https://api.serialmemory.dev" \
  -e SERIALMEMORY_API_KEY="your-api-key" \
  serialcoder/serialmemory-mcp:latest

🔌 MCP Integration

Claude Desktop

Modify:

~/Library/Application Support/Claude/claude_desktop_config.json

Add:

{
  "mcpServers": {
    "serialmemory": {
      "command": "/path/to/serialmemory-mcp"
    }
  }
}

Restart Claude.

Cursor

~/.cursor/mcp.json

{
  "serialmemory": {
    "command": "/path/to/serialmemory-mcp"
  }
}

Kilo Code

~/.kilocode/mcp.json

{
  "servers": {
    "serialmemory": {
      "command": "/path/to/serialmemory-mcp"
    }
  }
}

🧩 Tools

Tool Description
memory.search Semantic & keyword search
memory.add Add a memory item
memory.update Update an existing memory
memory.delete Remove a memory
memory.list_recent Recently added memories
session.list Conversation sessions
graph.query Knowledge-graph query

All calls proxy to:
POST /api/mcp/tools/<toolName>

🏗 Development

git clone https://github.com/sblanchard/SerialMemory-MCP
cd SerialMemory-MCP
dotnet build
dotnet run --project SerialMemory.Mcp

🐳 Dockerfile (included)

FROM mcr.microsoft.com/dotnet/runtime:10.0
WORKDIR /app
COPY . .
ENTRYPOINT ["./serialmemory-mcp"]

🔧 Troubleshooting

Mac: SSE Transport Authentication Fails

Error:

HTTP 404: Invalid OAuth error response: SyntaxError: JSON Parse error: Unexpected EOF. Raw body:

Cause: The MCP SDK on Mac with SSE transport performs OAuth discovery, hitting /.well-known/oauth-authorization-server. If this returns 404 with an empty body, JSON parsing fails.

Solution: Use http transport instead of sse:

{
  "mcpServers": {
    "serialmemory": {
      "type": "http",
      "url": "http://localhost:4545/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

This works on all platforms (Windows, Linux, macOS).

🔐 Security

  • No local storage
  • No embeddings
  • No database access
  • Pure HTTPS proxy
  • Safe in enterprise environments

🗒 Changelog

v1.0.0

  • First public release
  • Claude, Cursor, Kilo Code support
  • Docker build
  • Multi-OS support
  • Stateless MCP proxy

📜 License

MIT License © Serialcoder