Skip to content

feat(mcp): remote mcp server #116

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 1 commit into
base: main
Choose a base branch
from
Draft
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
71 changes: 43 additions & 28 deletions sqlite-cloud/platform/mcp-server.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -39,13 +39,13 @@ If the command returns a version number, Node.js is installed. If you see an err

## Configure the AI Agent

This guide explains how to connect the MCP Server for SQLite Cloud to common AI agents that support MCP.
This guide explains how to connect the MCP Server for SQLite Cloud to common AI agents that support MCP.
[Find a list of supported tools and IDEs here](https://modelcontextprotocol.io/clients).

After configuring your AI agent, try asking it questions about your SQLite Cloud database, such as:

> What’s in my database on SQLite Cloud?"
"What are the three most popular tracks by revenue in my SQLite Cloud database?
> "What are the three most popular tracks by revenue in my SQLite Cloud database?

Explore or manipulate your database using natural language queries.

Expand All @@ -61,20 +61,18 @@ Refer to the [official documentation](https://modelcontextprotocol.io/quickstart
{
"mcpServers": {
"sqlitecloud-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sqlitecloud/mcp-server",
"--connectionString",
"<CONNECTION_STRING>"
]
"type": "sse",
"url": "https://<SERVER_URL>/v1/mcp/sse",
"headers": {
"Authorization": "Bearer <CONNECTION_STRING>"
}
}
}
}
```

Replace `<CONNECTION_STRING>` with your Connection String.
Replace `<SERVER_URL>` with the `Servers` url in the **Weblite** section on the Dashboard.
Replace `<CONNECTION_STRING>` with your **Connection String** in the **Connect** section on the Dashboard.

4. Save the configuration file and restart Claude Desktop.
5. You should see a _Hammer_ icon in the bottom-right corner of the input box. Click the icon to view the list of discovered tools.
Expand All @@ -90,20 +88,18 @@ Refer to the [official documentation](https://docs.cursor.com/context/model-cont
{
"mcpServers": {
"sqlitecloud-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sqlitecloud/mcp-server",
"--connectionString",
"<CONNECTION_STRING>"
]
"type": "sse",
"url": "https://<SERVER_URL>/v1/mcp/sse",
"headers": {
"Authorization": "Bearer <CONNECTION_STRING>"
}
}
}
}
```

Replace `<CONNECTION_STRING>` with your Connection String.
Replace `<SERVER_URL>` with the `Servers` url in the **Weblite** section on the Dashboard.
Replace `<CONNECTION_STRING>` with your **Connection String** in the **Connect** section on the Dashboard.

3. Save the `mcp.json` file.
4. Open the **Settings** page and navigate to the **MCP** section. You should see the MCP server with a green status indicator.
Expand All @@ -129,19 +125,38 @@ Refer to the [official documentation](https://code.visualstudio.com/docs/copilot
],
"servers": {
"sqlitecloud-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sqlitecloud/mcp-server",
"--connectionString",
"${input:sqlitecloud-connection-string}"
]
"type": "sse",
"url": "https://<SERVER_URL>/v1/mcp/sse",
"headers": {
"Authorization": "Bearer ${input:sqlitecloud-connection-string}"
}
}
}
}
}
```

Replace `<SERVER_URL>` with the `Servers` url in the **Weblite** section on the Dashboard.
Get your **Connection String** in the **Connect** section on the Dashboard.

3. Save the `mcp.json` file.
4. Open Copilot Chat and select the **Agent** mode from the menu near the **Send** button. A tool icon will appear, showing the discovered tools. Before starting the server, VSCode will prompt you to enter your Connection String.

## Local MCP Server

Run the MCP server locally by using this configuration:

```json
"sqlitecloud-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sqlitecloud/mcp-server",
"--connectionString",
"<CONNECTION_STRING>"
]
}
```

Replace `<CONNECTION_STRING>` with your **Connection String** in the **Connect** section on the Dashboard.