mem-brain-mcp 1.0.0__py3-none-any.whl

mem_brain_mcp-1.0.0.dist-info/METADATA

@@ -0,0 +1,176 @@
+Metadata-Version: 2.4
+Name: mem-brain-mcp
+Version: 1.0.0
+Summary: MCP Server for Mem-Brain API - Exposes memory operations as MCP tools
+Keywords: ai,claude,cursor,llm,mcp,memory,model-context-protocol
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: <3.14,>=3.10
+Requires-Dist: fastmcp<3.0.0,>=2.0.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: uvicorn[standard]>=0.27.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.4.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Mem-Brain MCP Server
+
+MCP (Model Context Protocol) server that exposes Mem-Brain API functionality as standardized tools for AI agents. Built with [FastMCP](https://gofastmcp.com) for production-ready HTTP/SSE transport.
+
+## Features
+
+- **Memory Management**: Create, read, update, and delete memories
+- **Semantic Search**: Search memories using vector similarity
+- **Graph Operations**: Find paths and neighborhoods in the memory graph
+- **Statistics**: Get insights about your memory system
+- **Link Management**: Link and unlink memories
+- **HTTP/SSE Transport**: Run independently, accessible remotely
+- **CLI Interface**: Packaged for easy global execution
+
+## Instant Execution (Recommended)
+
+You can run the MCP server instantly without manual installation using `uv`:
+
+```bash
+# Run using uvx (loads environment from .env or shell)
+uvx mem-brain-mcp
+
+# Run with custom API URL
+export API_BASE_URL=http://your-api-alb-url.com
+uvx mem-brain-mcp
+```
+
+## Installation
+
+### From Source
+
+1. Install using `uv` (recommended) or `pip`:
+
+```bash
+cd mem-brain-mcp
+uv pip install .
+```
+
+2. Run globally:
+
+```bash
+mem-brain-mcp
+```
+
+## Configuration
+
+The server reads configuration from environment variables or a `.env` file in the current working directory:
+
+```env
+# API Configuration
+API_BASE_URL=http://localhost:8000
+# NOTE: API_KEY is optional here - per-user API keys are configured in MCP clients
+API_KEY=your_api_key_here  # Optional: fallback for single-user scenarios
+
+# MCP Server Configuration
+MCP_SERVER_HOST=0.0.0.0
+MCP_SERVER_PORT=8100
+
+# Logging
+LOG_LEVEL=INFO
+```
+
+## Per-User API Key Configuration
+
+Each user must configure their own API key in their MCP client for proper user isolation. The server extracts tokens from request headers.
+
+### Cursor IDE (`~/.cursor/mcp.json`)
+
+```json
+{
+  "mcpServers": {
+    "mem-brain": {
+      "url": "http://localhost:8100/mcp",
+      "headers": {
+        "Authorization": "Bearer your-jwt-token"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+#### Option 1: Native Remote (Pro/Team plans)
+Add to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "mem-brain": {
+      "url": "http://your-deployed-url/mcp",
+      "headers": {
+        "Authorization": "Bearer your-jwt-token"
+      }
+    }
+  }
+}
+```
+
+#### Option 2: via CLI (Any plan)
+```json
+{
+  "mcpServers": {
+    "mem-brain": {
+      "command": "uvx",
+      "args": ["mem-brain-mcp"],
+      "env": {
+        "API_BASE_URL": "http://your-deployed-url",
+        "JWT_SECRET_KEY": "your-secret"
+      }
+    }
+  }
+}
+```
+
+## AWS ECS Deployment
+
+The MCP server can be deployed to AWS ECS (Fargate) with an Application Load Balancer.
+
+### Quick Start
+
+1. **Set up security groups** (see [aws/security-groups.md](./aws/security-groups.md))
+2. **Deploy using the script:**
+
+```bash
+cd mem-brain-mcp/aws
+./deploy.sh ap-south-1 membrain-mcp membrain-cluster membrain-mcp
+```
+
+For detailed instructions, see [aws/DEPLOYMENT.md](./aws/DEPLOYMENT.md).
+
+## Development
+
+### Running Tests
+```bash
+pytest
+```
+
+### Build and Publish
+```bash
+# Build the wheel
+python3 -m build
+
+# Upload to PyPI
+twine upload dist/*
+```
+
+## License
+
+Same as Mem-Brain API project.

mem_brain_mcp-1.0.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+mem_brain_mcp/__init__.py,sha256=DifX5h1zBo_ResWlU7kT_HFCeptgPaJouZ03wxBUSqc,89
+mem_brain_mcp/__main__.py,sha256=H_mwoKm1FBmu4KzAcQcq-TXZqeNvlrAekAxB1s4F4hA,712
+mem_brain_mcp/client.py,sha256=7KFGcLoPDaOOLiuG2lygQK7xH5Kio-YifDjuSpDoDJ8,6993
+mem_brain_mcp/config.py,sha256=mu2HQPKkEjV_2QnlQ2gq7u0niXIvDCwpOgo7dRJjEcI,1055
+mem_brain_mcp/server.py,sha256=mlbl3-D3OFb4HHP54daqiP3nMWEdiTv3upEdUFnlhAA,39604
+mem_brain_mcp-1.0.0.dist-info/METADATA,sha256=xeGMlWratQ-1jPrI3A8E3hc_AdrxI9VLOBPZStgWmWk,4327
+mem_brain_mcp-1.0.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+mem_brain_mcp-1.0.0.dist-info/entry_points.txt,sha256=NH6QYQ-Sd8eJn5crpe_DL1PvGeUlL3y65968xPhmwG8,62
+mem_brain_mcp-1.0.0.dist-info/RECORD,,

mem_brain_mcp-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

mem_brain_mcp-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mem-brain-mcp = mem_brain_mcp.__main__:main