|
1 | | - |
| 1 | + |
2 | 2 |
|
3 | 3 | ## Table of Contents |
4 | 4 |
|
5 | 5 | - [Overview](#connx-mcp-server) |
6 | 6 | - [Sample Features](#features) |
7 | 7 | - [Installation](#installation) |
8 | | -- [Testing](#testing-) |
| 8 | +- [Testing](#testing) |
9 | 9 | - [Usage](#usage) |
10 | 10 | - [MCP Tools](#mcp-tools) |
11 | 11 | - [`query_connx`](#query_connx) |
@@ -39,7 +39,7 @@ The server is not intended to be a complete or hardened production solution. Ins |
39 | 39 | - For Linux: unixODBC with CONNX driver |
40 | 40 |
|
41 | 41 | ## Installation |
42 | | -1. Clone the repo: `git clone https://github.com/djecon-sag/CONNX_MCP_Sample.git` |
| 42 | +1. Clone the repo: `git clone https://github.com/SoftwareAG/CONNX_MCP_Sample.git` |
43 | 43 | 2. Install dependencies: `pip install -r requirements.txt` |
44 | 44 | 3. Configure CONNX DSN (see Configuration section below) |
45 | 45 |
|
@@ -253,9 +253,12 @@ Coverage includes connection handling, query/update execution, sanitization, and |
253 | 253 | ### Common Issues |
254 | 254 |
|
255 | 255 | **ODBC Connection Failure** |
256 | | -- Verify CONNX DSN is properly configured: `odbcinst -q -d` |
257 | 256 | - Check credentials and network connectivity |
258 | 257 | - Ensure CONNX service is running |
| 258 | +- Verify CONNX DSN is properly configured: |
| 259 | + - **Windows**: Open the ODBC Data Source Administrator by searching for "ODBC Data Sources" in the Start menu (use the 64-bit version if applicable, or odbcad32.exe for 32-bit). Check if your CONNX DSN is listed under the "User DSN" or "System DSN" tab. Double-click the DSN to test the connection. |
| 260 | + - **Linux**: Use `odbcinst -q -s` (from unixODBC) to list configured DSNs and confirm yours appears. To list drivers, use `odbcinst -q -d`. Test the connection with `isql -v your_dsn_name your_username your_password`. |
| 261 | + - **macOS**: If using unixODBC (common setup), follow the Linux instructions above. If using iODBC, use `iodbctest` or check `/Library/ODBC/odbc.ini` (system-wide) or `~/Library/ODBC/odbc.ini` (user-specific) for DSN entries. Test with `iodbctest "DSN=your_dsn_name;UID=your_username;PWD=your_password"`. |
259 | 262 |
|
260 | 263 | **Permission Denied** |
261 | 264 | - Verify database user has appropriate SELECT/UPDATE/INSERT/DELETE privileges |
@@ -567,4 +570,4 @@ It is intended as: |
567 | 570 | * A reference implementation |
568 | 571 | * A starting point for secure MCP server development |
569 | 572 |
|
570 | | -It is not intended to replace enterprise-grade security controls. |
| 573 | +It is not intended to replace enterprise-grade security controls. |
0 commit comments