You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+14-5Lines changed: 14 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,7 @@
1
1
# MCP Server - Oracle DB Context
2
2
3
+
[English](README.md) | [中文](README-zh.md)
4
+
3
5
A powerful Model Context Protocol (MCP) server that provides contextual database schema information for large Oracle databases, enabling AI assistants to understand and work with databases containing thousands of tables.
4
6
5
7
## Table of Contents
@@ -101,7 +103,8 @@ In VSCode Insiders, go to your user or workspace `settings.json` file and add th
"THICK_MODE":""// Optional: set to "1" to enable thick mode
106
+
"THICK_MODE":"", // Optional: set to "1" to enable thick mode
107
+
"ORACLE_CLIENT_LIB_DIR":""// Optional: in case you use thick mode and you want to set a non-default directory for client libraries
105
108
}
106
109
}
107
110
}
@@ -111,6 +114,7 @@ In VSCode Insiders, go to your user or workspace `settings.json` file and add th
111
114
When using Docker (recommended approach):
112
115
- All dependencies are included in the container
113
116
- Set `THICK_MODE=1` in the environment variables to enable thick mode if needed
117
+
- If you use `THICK_MODE`, you can optionally set the path where Oracle Client libraries are installed with `ORACLE_CLIENT_LIB_DIR` if it differs from the default location.
114
118
115
119
#### Option 2: Using UV (Local Installation)
116
120
@@ -174,7 +178,8 @@ In VSCode Insiders, go to your user or workspace `settings.json` file and add th
"THICK_MODE":"" // Optional: set to "1" to enable thick mode
181
+
"THICK_MODE":"", // Optional: set to "1" to enable thick mode
182
+
"ORACLE_CLIENT_LIB_DIR":"" // Optional: incase you use thick mode and if you want to set a non-default directory for client libraries
178
183
}
179
184
}
180
185
}
@@ -193,8 +198,6 @@ To run the MCP server directly:
193
198
194
199
```bash
195
200
uv run main.py
196
-
# Reference: uv run --python D:\oracle-mcp-server\.venv\Scripts\python.exe --with mcp[cli] mcp run D:\oracle-mcp-server\main.py
197
-
# Reference By Supergateway: npx -y supergateway --stdio "uv run main.py" --port 8000 --baseUrl http://localhost:8000 --ssePath /sse --messagePath /message (Subscribe to events: GET http://localhost:8000/sse;Send messages: POST http://localhost:8000/message)
198
201
```
199
202
200
203
For development and testing:
@@ -339,7 +342,13 @@ For scenarios requiring advanced Oracle features or better performance, you can
339
342
- When using Docker (recommended): Set `THICK_MODE=1` in the Docker environment variables
340
343
- When using local installation: Export `THICK_MODE=1` environment variable and ensure Oracle Client libraries, compatible with your system architecture and database version, are installed
341
344
342
-
Note: When using Docker, you don't need to worry about installing Oracle Client libraries as they are included in the container (Oracle Instant Client v23.7). The container supports Oracle databases versions 19c up to 23ai in both linux/arm64 and linux/amd64 architectures.
345
+
You can specify a custom location for the Oracle Client libraries using the `ORACLE_CLIENT_LIB_DIR` environment variable. This is particularly useful when:
346
+
- You have Oracle Client libraries installed in non-standard locations
347
+
- You need to work with multiple Oracle Client versions on the same system
348
+
- You don't have administrative privileges to install Oracle Client in standard locations
349
+
- You need specific Oracle Client versions for compatibility with certain database features
350
+
351
+
Note: When using Docker, you don't need to worry about installing Oracle Client libraries as they are included in the container (Oracle Instant Client v23.7). The container supports Oracle databases versions 19c up to 23ai in both linux/arm64 and linux/amd64 architectures.
0 commit comments