From e8230448ada1c21118521e5b045dedcbef28c22f Mon Sep 17 00:00:00 2001 From: Mahesh Murag Date: Wed, 20 Nov 2024 11:05:58 -0500 Subject: [PATCH] Updated Postgres --- README.md | 42 ++++++++++++--------------------------- src/postgres/README.md | 35 ++++++++++++++++++++++++++++++-- src/postgres/package.json | 2 +- 3 files changed, 47 insertions(+), 32 deletions(-) diff --git a/README.md b/README.md index 6bf28e57..782a8278 100644 --- a/README.md +++ b/README.md @@ -1,37 +1,21 @@ -# PostgreSQL +# MCP servers ![NPM Version](https://img.shields.io/npm/v/%40modelcontextprotocol%2Fexample-servers) -A Model Context Protocol server that provides read-only access to PostgreSQL databases. This server enables LLMs to inspect database schemas and execute read-only queries. +Example servers for the Model Context Protocol, to demonstrate the kinds of things you can do! -## Components +## Getting started -### Tools +Install from npm: -- **query** - - Execute read-only SQL queries against the connected database - - Input: `sql` (string): The SQL query to execute - - All queries are executed within a READ ONLY transaction - -### Resources - -The server provides schema information for each table in the database: - -- **Table Schemas** (`postgres:////schema`) - - JSON schema information for each table - - Includes column names and data types - - Automatically discovered from database metadata - -## Example Usage with the Desktop App +```sh +npm install -g @modelcontextprotocol/servers +``` -To use this server with the Claude Desktop app, add the following configuration to the "mcpServers" section of your `claude_desktop_config.json`: +Then, the servers will be globally available on your PATH: -```json -"postgres": { - "command": "mcp-server-postgres", - "args": ["postgresql://localhost/mydb"], - "env": { - "HOME": "/Users/YOUR_USERNAME" - } -} +```sh +mcp-server-everything +mcp-server-postgres +# ... ``` -Replace `/mydb` with your database name and `YOUR_USERNAME` with your system username. \ No newline at end of file +Each server will operate differently. See the READMEs within [src](src/) for more information. \ No newline at end of file diff --git a/src/postgres/README.md b/src/postgres/README.md index 8f456d28..50a888c4 100644 --- a/src/postgres/README.md +++ b/src/postgres/README.md @@ -1,3 +1,34 @@ -# PostgreSQL server +# PostgreSQL -This MCP server provides **resources** and **tools** for interacting with a Postgres database. +A Model Context Protocol server that provides read-only access to PostgreSQL databases. This server enables LLMs to inspect database schemas and execute read-only queries. + +## Components + +### Tools + +- **query** + - Execute read-only SQL queries against the connected database + - Input: `sql` (string): The SQL query to execute + - All queries are executed within a READ ONLY transaction + +### Resources + +The server provides schema information for each table in the database: + +- **Table Schemas** (`postgres:///
/schema`) + - JSON schema information for each table + - Includes column names and data types + - Automatically discovered from database metadata + +## Example Usage with the Desktop App + +To use this server with the Claude Desktop app, add the following configuration to the "mcpServers" section of your `claude_desktop_config.json`: + +```json +"postgres": { + "command": "mcp-server-postgres", + "args": ["postgresql://localhost/mydb"] +} +``` + +Replace `/mydb` with your database name. diff --git a/src/postgres/package.json b/src/postgres/package.json index cbf588be..28ca52fd 100644 --- a/src/postgres/package.json +++ b/src/postgres/package.json @@ -19,7 +19,7 @@ "watch": "tsc --watch" }, "dependencies": { - "@modelcontextprotocol/sdk": "0.5.0", + "@modelcontextprotocol/sdk": "0.6.2", "pg": "^8.13.0" }, "devDependencies": {