Skip to content

feat(remote): cloudflare worker #45

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 16 commits into
base: feat/sse-server
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -144,3 +144,7 @@ dist
# End of https://www.toptal.com/developers/gitignore/api/node

.idea/

# Cloudflare
.wrangler
.dev.vars
36 changes: 30 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,6 +107,8 @@ Here are some example prompts to get you started:

### Claude Desktop Setup

#### Local

1. Open Claude Desktop settings
2. Add the following to your configuration:
```json
Expand All @@ -123,6 +125,27 @@ Here are some example prompts to get you started:
> [!TIP]
> You can refer to the [official documentation](https://modelcontextprotocol.io/quickstart/user) for Claude Desktop.

#### Remote
To run an HTTP server, as Claude Desktop doesn't natively support it yet, you'll have to use a gateway:
```json
{
"mcpServers": {
"algolia-mcp": {
"command": "<PATH_TO_BIN>/npx",
"args": [
"-y",
"mcp-remote",
"http://localhost:4243/mcp"
]
}
}
}
```
> [!INFO]
> Our HTTP server leverages the [Streamable HTTP transport](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http).
> It is also backward compatible with the [SSE transport](https://modelcontextprotocol.io/docs/concepts/transports#server-sent-events-sse).


### CLI Options

#### Available Commands
Expand All @@ -131,14 +154,15 @@ Here are some example prompts to get you started:
Usage: algolia-mcp [options] [command]

Options:
-h, --help display help for command
-h, --help Display help for command

Commands:
start-server [options] Starts the Algolia MCP server
authenticate Authenticate with Algolia
logout Remove all stored credentials
list-tools List all available tools
help [command] display help for command
start-server [options] Starts the Algolia MCP server
start-sse-server [options] Starts the Algolia MCP SSE server
authenticate Authenticate with Algolia
logout Remove all stored credentials
list-tools List all available tools
help [command] Display help for command
```

#### Server Options
Expand Down
Loading
Loading