Metadata-Version: 2.4
Name: obris-mcp
Version: 0.2.1
Summary: MCP server for Obris — bring your saved knowledge into AI conversations
License-Expression: MIT
License-File: LICENSE
Keywords: ai,context,knowledge,mcp,obris
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp[cli]>=1.0.0
Requires-Dist: python-dotenv>=1.0.0
Description-Content-Type: text/markdown

# Obris MCP Server

An [MCP](https://modelcontextprotocol.io/) server that brings your saved [Obris](https://obris.ai) knowledge into AI conversations on Claude, ChatGPT, Gemini, and any MCP-compatible client.

## Features

- **List topics** — Browse all your Obris topics to find the one you need
- **Pull in knowledge** — Retrieve saved bookmarks, highlights, and notes as context for any conversation
- **Read-only** — The server only reads your data; it never modifies anything in your Obris account

## Setup

### 1. Get your API key

Generate an API key from your [Obris dashboard](https://app.obris.ai/api-keys). Don't have an account? [Sign up](https://app.obris.ai/signup).

### 2. Install and configure

#### Claude Desktop (Recommended)

Build and install the extension bundle:

```bash
npm install -g @anthropic-ai/mcpb
git clone https://github.com/obris-dev/obris-mcp.git
cd obris-mcp
mcpb pack .
```

Then in Claude Desktop, go to **Settings > Extensions > Install Extension** and select the generated `obris-mcp.mcpb` file. You'll be prompted to enter your [API key](https://app.obris.ai/api-keys) during setup.

#### Claude Desktop (Manual config)

Alternatively, add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):

```json
{
  "mcpServers": {
    "obris": {
      "command": "uvx",
      "args": ["obris-mcp"],
      "env": {
        "OBRIS_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

#### Other MCP clients

```bash
# Install
pip install obris-mcp

# Set your API key
export OBRIS_API_KEY=your_api_key_here

# Run
obris-mcp
```

## Tools

| Tool | Description |
|------|-------------|
| `list_topics` | List all your Obris topics |
| `get_topic_knowledge` | Get saved knowledge for a specific topic |

## Examples

### Example 1: Listing your topics

**Prompt:** "What Obris topics do I have?"

The `list_topics` tool is called and returns:

```
Topics:
- Marketing Strategy (id: 01JEXAMPLE00001)
- Product Roadmap (id: 01JEXAMPLE00002)
- Competitive Analysis (id: 01JEXAMPLE00003)
```

### Example 2: Getting knowledge for a topic

**Prompt:** "Pull in my saved knowledge for the Marketing Strategy topic."

The `list_topics` tool is called first to find the topic ID, then `get_topic_knowledge` is called with `topic_id: "01JEXAMPLE00001"`:

```
### How to Build a Content Strategy
Content strategy starts with understanding your audience...
(source: https://example.com/content-strategy)
---
### SEO Best Practices 2025
Focus on search intent rather than keyword density...
(source: https://example.com/seo-guide)
```

### Example 3: Using knowledge as context for a task

**Prompt:** "Using my Competitive Analysis knowledge, summarize the key differentiators of our top 3 competitors."

The `list_topics` tool finds the Competitive Analysis topic, then `get_topic_knowledge` retrieves all saved knowledge. The AI uses that knowledge as context to generate a structured summary of competitor differentiators based on your saved research.

## Development

```bash
# Clone and install
git clone https://github.com/obris-dev/obris-mcp.git
cd obris-mcp
cp .env.example .env  # Add your API key

# Install with uv
uv sync

# Run locally
uv run obris-mcp
```

## Privacy Policy

This server sends your Obris API key to the Obris API (`api.obris.ai`) to authenticate requests. It retrieves topic and knowledge data from your account. No data is stored locally or sent to any third party.

For the full privacy policy, see [obris.ai/privacy](https://obris.ai/privacy).

## Support

For issues or questions, contact [support@obris.ai](mailto:support@obris.ai) or open an issue on [GitHub](https://github.com/obris-dev/obris-mcp/issues).

## License

MIT