biszx-odoo-mcp 1.2.0__py3-none-any.whl

biszx_odoo_mcp-1.2.0.dist-info/METADATA

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: biszx-odoo-mcp
+Version: 1.2.0
+Summary: MCP Server for Odoo Integration
+Author-email: Biszx <isares.br@gmail.com>
+License: MIT
+Project-URL: Homepage, https://gitlab.com/biszx/biszx-odoo-mcp
+Project-URL: Issues, https://gitlab.com/biszx/biszx-odoo-mcp/issues
+Keywords: odoo,mcp,server
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: asyncio>=3.4.3
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: mcp[cli]>=1.9.4
+Requires-Dist: odoorpc>=0.10.1
+Dynamic: license-file
+
+# Odoo MCP Server
+
+An MCP server implementation for Odoo ERP systems, providing a set of tools for managing Odoo records, models, and custom methods.
+Inspired by [tuanle96/mcp-odoo](https://github.com/tuanle96/mcp-odoo).
+
+## Tools
+
+### Core CRUD Operations
+
+- **create_record**: Create a single new record
+
+  - Inputs: `model_name` (string), `values` (object)
+  - Returns: Dictionary with created record ID
+
+- **create_records**: Create multiple records at once
+
+  - Inputs: `model_name` (string), `values_list` (array of objects)
+  - Returns: Dictionary with created record IDs
+
+- **read_records**: Read specific records by their IDs
+
+  - Inputs: `model_name` (string), `ids` (array), `fields` (optional array)
+  - Returns: Dictionary with record data
+
+- **write_record**: Update a single record
+
+  - Inputs: `model_name` (string), `record_id` (number), `values` (object)
+  - Returns: Dictionary with operation result
+
+- **write_records**: Update multiple records
+
+  - Inputs: `model_name` (string), `record_ids` (array), `values` (object)
+  - Returns: Dictionary with operation result
+
+- **unlink_record**: Delete a single record
+
+  - Inputs: `model_name` (string), `record_id` (number)
+  - Returns: Dictionary with operation result
+
+- **unlink_records**: Delete multiple records
+  - Inputs: `model_name` (string), `record_ids` (array)
+  - Returns: Dictionary with operation result
+
+### Search and Query Operations
+
+- **search_records**: Search for records with advanced filtering
+
+  - Inputs: `model_name` (string), `domain` (array), `fields` (optional array), `limit` (optional number), `offset` (optional number), `order` (optional string)
+  - Returns: Dictionary with matching records
+
+- **search_ids**: Get only IDs of matching records
+
+  - Inputs: `model_name` (string), `domain` (array), `offset` (optional number), `limit` (optional number), `order` (optional string)
+  - Returns: Dictionary with list of IDs
+
+- **search_count**: Count records matching a domain
+  - Inputs: `model_name` (string), `domain` (array)
+  - Returns: Dictionary with count
+
+### Model Operations
+
+- **search_models**: Search for available models in the Odoo system
+
+  - Inputs: `query` (string) - Search term for model names and display names
+  - Returns: Dictionary with matching models
+
+- **get_model_info**: Get information about a specific model
+
+  - Inputs: `model_name` (string)
+  - Returns: Dictionary with model information
+
+- **get_model_fields**: Get field definitions for a model
+  - Inputs: `model_name` (string), `query_field` (string)
+  - Returns: Dictionary with field definitions
+
+### Utility Operations
+
+- **search_and_update**: Search and update records in one operation
+
+  - Inputs: `model_name` (string), `domain` (array), `values` (object)
+  - Returns: Dictionary with affected record count and IDs
+
+- **call_method**: Call custom methods on models
+
+  - Inputs: `model_name` (string), `method_name` (string), `args` (optional array), `kwargs` (optional object)
+  - Returns: Dictionary with method result
+
+## Resources
+
+### Model Information
+
+- **odoo://models/search/{query}**: Search for models by name or description
+- **odoo://models/{model_name}/info**: Information about a specific model
+- **odoo://models/{model_name}/fields**: Field definitions for a specific model
+
+### Documentation
+
+- **odoo://help/domains**: Complete guide to Odoo domain syntax with examples
+- **odoo://help/operations**: Documentation of all available MCP tools and workflows
+
+## Configuration
+
+### Odoo Connection Setup
+
+To connect to your Odoo instance, set the following environment variables:
+
+- `ODOO_URL`: Your Odoo server URL
+- `ODOO_DB`: Database name
+- `ODOO_USERNAME`: Login username
+- `ODOO_PASSWORD`: Password or API key
+- `ODOO_TIMEOUT`: Connection timeout in seconds (default: 30)
+- `ODOO_VERIFY_SSL`: Whether to verify SSL certificates (default: true)
+- `LOG_LEVEL`: Logging level (default: INFO)
+
+### Usage with Claude Desktop
+
+Add this to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "odoo": {
+      "command": "uvx",
+      "args": ["biszx-odoo-mcp"],
+      "env": {
+        "ODOO_URL": "https://your-odoo-instance.com",
+        "ODOO_DB": "your-database-name",
+        "ODOO_USERNAME": "your-username",
+        "ODOO_PASSWORD": "your-password-or-api-key"
+      }
+    }
+  }
+}
+```
+
+## Installation
+
+### Python Package
+
+```bash
+pip install biszx-odoo-mcp
+```
+
+### Running the Server
+
+```bash
+# Using the installed package
+biszx-odoo-mcp
+
+# Using uv for development
+uv run biszx-odoo-mcp
+
+# Using the MCP development tools
+uv run mcp dev src/biszx_odoo_mcp/main.py
+```
+
+## License
+
+This MCP server is licensed under the MIT License.

biszx_odoo_mcp-1.2.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+biszx_odoo_mcp/__init__.py,sha256=J-K5_2GapE12EHcbhrotvjxKDYFS2aGa_eIpcsnHjIg,58
+biszx_odoo_mcp/__main__.py,sha256=b7dX--Aowgjuvgr8Sh4aXa63TCwxPa_vLjh7JYReFz0,1256
+biszx_odoo_mcp/exceptions.py,sha256=vVMyZekFmZIg2SsH53zcefWp_swqFkE4lxQin1OVgB0,6611
+biszx_odoo_mcp/main.py,sha256=Rr2WNMscXqlIQUsKpEPVySQhy5BD6M8kGzLkV_zvp4Q,3889
+biszx_odoo_mcp/server/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+biszx_odoo_mcp/server/context.py,sha256=PxyFxFXL3GDpUynm4j63RiUjjIagDfy1oLh1cjPfvVA,378
+biszx_odoo_mcp/server/resources.py,sha256=EliQzuWDKibpd5MPWb2FyM65acll7EkvjYcxdLBFmsw,8389
+biszx_odoo_mcp/server/response.py,sha256=VY85S0JPpR7F1lxweZV_lqB1cqhGtGRbsTkkBmPXimo,877
+biszx_odoo_mcp/server/tools.py,sha256=yNYkzUg6aQ3U-f0EtBBvMHBkmCDknP4bd9JzZDphokA,14153
+biszx_odoo_mcp/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+biszx_odoo_mcp/tools/config.py,sha256=xdV6L9CATO1PDSk6nenh1fCimONHGo25UAVuoulGFbo,2869
+biszx_odoo_mcp/tools/odoo_client.py,sha256=jXJ88R0SfDIWqcAXq9uZlphnXEu5S80yIBMw6x3wQYc,23464
+biszx_odoo_mcp-1.2.0.dist-info/licenses/LICENSE,sha256=_FwB4PGxcQWsToTqX33moF0HqnB45Ox6Fr0VPJiLyBI,1071
+biszx_odoo_mcp-1.2.0.dist-info/METADATA,sha256=uF3FggYTMsxAjqq7ndgQ8vgZK_BoUJQGPT_Z28tWP74,5394
+biszx_odoo_mcp-1.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+biszx_odoo_mcp-1.2.0.dist-info/entry_points.txt,sha256=vdIkuiVsddBLNV--8Wgaf8xHu6Pdi2DAia-ISGNdxP0,64
+biszx_odoo_mcp-1.2.0.dist-info/top_level.txt,sha256=l6PxKyczED68V9LsRlWYClo1GfjSJaP9V-SDMnAUJbU,15
+biszx_odoo_mcp-1.2.0.dist-info/RECORD,,

biszx_odoo_mcp-1.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

biszx_odoo_mcp-1.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+biszx-odoo-mcp = biszx_odoo_mcp.__main__:main

biszx_odoo_mcp-1.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Lê Anh Tuấn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

biszx_odoo_mcp-1.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+biszx_odoo_mcp