Skip to main content
Glama
odxproxy-mcpserver

odxproxy-mcpserver

by terrakernel

ODXProxy MCP Server

Official MCP Server for ODXProxy by TERRAKERNEL. PTE. LTD.

Overview

This package provides a Model Context Protocol (MCP) server that connects ODXProxy with MCP-compatible clients/tools. It exposes capabilities to interact with ODX/Odoo resources programmatically.

Related MCP server: odoo-mcp

Status

Early version (0.1.x). Expect breaking changes as the APIs evolve.

Usage

See the entry points in src/index.ts and src/server.ts. Typical usage is to import the built output from dist after building.

import {OdxInstanceInfo, OdxMCPServer,OdxProxyClientInfo} from "odxproxy-mcpserver";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";


async function main() {
    const env = process.env;
    let clientInfo: OdxProxyClientInfo = {
        instance: {
            url: "ODOO_INSTANCE_URL",
            user_id: 2,
            db: "DB_NAME",
            api_key: "YOUR_ODOO_API_KEY"
        },
        odx_api_key: "YOUR_ODXPROXY_API_KEY",
        gateway_url: "https://gateway.odxproxy.io"
    };
    let server = new OdxMCPServer(clientInfo);
    await server.initBaseResource();

    // If DRY_RUN is set, initialize and exit to allow smoke testing without stdio hang.
    if (env.DRY_RUN === "1") {
        return;
    }
    let transport = new StdioServerTransport();
    await server.connect(transport);
}

main().catch((error) => {
    console.error(error);
});

You can also build the package locally and run from source.

Scripts

  • build: Build ESM/CJS and type declarations with tsup - test: Run Jest in CI mode with JUnit reporter - test:watch: Watch mode for Jest - prepublishOnly: Build and test before publishing

Run with:

npm run build

After you successfully build the package, embed the built output in your project to any supported LLM client like Claude Desktop or your own MCP Client. Visit https://modelcontextprotocol.io for more information about connecting to local MCP Servers

Development

  • Source code: src/

  • Resources: res/

  • Built artifacts: dist/

  • TypeScript config: tsconfig.json

License

MIT License © 2025 TERRAKERNEL. PTE. LTD See LICENSE file for full text.

Author

Julian Richie Wajong julian.wajong@gmail.com

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An extensible MCP server that integrates Odoo with LLMs to enable querying and managing business data like partners, quotations, and sales orders. It supports custom tool registration and multiple transport protocols for both local and remote communication.
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that connects AI assistants to Odoo ERP instances via the built-in XML-RPC API without requiring any additional addons. It enables users to search, create, update, and manage Odoo records and models through natural language.
      MIT