https://github.com/johnpatrickroach/surelook-holmes-mcp
https://github.com/johnpatrickroach/surelook-holmes-mcp
Last synced: about 18 hours ago
JSON representation
- Host: GitHub
- URL: https://github.com/johnpatrickroach/surelook-holmes-mcp
- Owner: johnpatrickroach
- Created: 2025-12-11T23:48:29.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-12-12T02:38:22.000Z (7 months ago)
- Last Synced: 2025-12-13T05:21:07.218Z (7 months ago)
- Language: Python
- Size: 23.4 KB
- Stars: 0
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Surelook Holmes MCP Server
A Model Context Protocol (MCP) server for Surelook Holmes, built with `fastmcp` and using SSE (Server-Sent Events) transport.
## Prerequisites
- Python 3.10+ (We recommend 3.12)
- `uv` (optional, but recommended for dependency management)
## Setup
1. **Create Virtual Environment**
Using `uv` (recommended):
```bash
uv venv --python 3.12 .venv
```
Or using standard `python`:
```bash
python3 -m venv .venv
```
2. **Install Dependencies**
```bash
uv pip install -p .venv fastmcp supabase python-dotenv requests
# OR
source .venv/bin/activate
pip install fastmcp supabase python-dotenv requests
```
3. **Configure Environment Variables**
Create a `.env` file in the project root:
```env
PUBLIC_SUPABASE_URL=your_project_url
PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY=your_public_key
RAPIDAPI_KEY=your_rapidapi_key
```
## Running the Server
Run the server using the configured transport (SSE):
```bash
.venv/bin/python mcp_server.py
```
By default, this will start the server on http://127.0.0.1:8000 (or similar default port provided by fastmcp).
## Features
- **Tools**:
- `get_identity(identity_id)`: Retrieve a specific identity by ID.
- `update_identity(identity_id, ...)`: Update an identity's details (name, relationship_status, linkedin_url, headshot_media_url, metadata).
- `get_events(session_id)`: List events associated with a session.
- `create_event(type, content, ...)`: Create a new event (types: 'VISUAL_OBSERVATION', 'NOTES', 'AGENT_WHISPER').
- `get_notes(identity_id)`: Retrieve conversation notes for a specific identity.
- `take_notes(identity_id, content)`: Save a conversation note for an identity.
- `who_is_this(linkedin_url)`: Identify a person and fetch their latest details from LinkedIn using RapidAPI.
- **Resources**:
- `system://info`: Basic system information.
## Transport
This server uses `streamable_http` transport (Streamable HTTP).