SAP Business One 10.0のServiceLayerにローカルネットワークで接続するためのMCP（Model Context Protocol）サーバー。GitHubリポジトリからnpxで実行でき、PCに何もインストールする必要はありません。
デフォルトは読み取り専用: SAP_B1_READONLY=true（デフォルト）の場合、クエリツール（GET）のみが登録されます。書き込みツール（POST/PATCH/DELETE）はサーバーに存在せず、呼び出すことはできません。
完全なディスカバリ: sap_list_entities、sap_get_entity_schema、sap_list_actionsはGET /$metadata（プロセスごとに一度だけダウンロードされキャッシュされる）を参照し、約140のCRUDエンティティ（ユーザーテーブル@やUDOを含む）とServiceLayerの数百のサービスメソッドを公開します。
オプションの書き込みモード: SAP_B1_READONLY=falseの場合、ServiceLayerエンティティ用のsap_create、sap_update、sap_deleteと、サービスメソッド用のsap_call_actionが有効になります（副作用がある可能性があります）。
npx github:による実行: 手動インストールは不要です。
セッション管理: CompanyDB/ユーザー名/パスワードによる暗黙のログイン、B1SESSION + ROUTEIDクッキーをメモリに保持（マルチノードServiceLayerをサポート）、401に対する自動再ログイン、プロセス終了時の確実なログアウト（sap_logoutツールに加えて）。
自己署名TLS: SAP_B1_VERIFY_TLS=falseにより、ServiceLayerの自己署名証明書（ローカル環境で一般的）をサポートします。
テレメトリや外部呼び出しなし: HTTPクライアントは設定されたURL（SAP_B1_SERVER_URL）のみを指します。
セキュリティ制限: topはクエリごとに200レコードに制限されます。
Related MCP server: BTP MCP Server
Tool | 説明 |
| 任意のODataエンティティへの汎用GET。 |
| ServiceLayerが公開するすべてのODataエンティティを一覧表示（ |
| エンティティのスキーマ: プロパティ（型/キー）とnavigationProperties（ |
| サービスメソッド（function imports、例: |
| 読み取り専用SQL（ |
| 取引先（顧客/仕入先）。 |
| カタログの品目 |
| 販売注文。v1では明細（ |
|
|
| アクティブなセッションの状態 |
| セッションの明示的な終了 |
SAP_B1_READONLY=falseの場合のみ）Tool | 説明 |
| エンティティにレコードを作成（ |
| キーでレコードを更新（ |
| キーでレコードを削除（ |
| サービスメソッドを呼び出し（ |
Node.js 18+
SAP Business One 10.0でServiceLayerが有効（一般的なパスはhttps://<host>:50000/b1s/v1）
opencode（または任意のMCPクライアント）
Variable | 必須 | デフォルト | 説明 |
| はい | - | ServiceLayerのベースURL（例: |
| はい | - | CompanyDB名（例: |
| はい | - | ServiceLayerのユーザー名 |
| はい | - | ユーザーのパスワード |
| いいえ |
|
|
| いいえ |
|
|
| いいえ |
| クエリごとの |
プロジェクトのopencode.jsonに:
{
"mcp": {
"sap-b1-servicelayer": {
"type": "local",
"command": ["npx", "-y", "github:leonardows1/sap-b1-servicelayer-mcp"],
"environment": {
"SAP_B1_SERVER_URL": "https://<host>:50000/b1s/v1",
"SAP_B1_DATABASE": "<CompanyDB>",
"SAP_B1_USERNAME": "<usuario>",
"SAP_B1_PASSWORD": "<password>",
"SAP_B1_SESSION_TIMEOUT": "30",
"SAP_B1_VERIFY_TLS": "false",
"SAP_B1_READONLY": "true"
},
"enabled": true
}
}
}設定を保存した後、opencodeを再起動してください。
資格情報とセッションクッキーはログに記録されることはありません。
プロセスはSAP_B1_SERVER_URLとのみ通信します。
READONLY=trueモードでは書き込みツールは登録されません。設計上、レコードの作成/更新/削除は不可能です。
起動時に設定を検証: SAP_B1_SERVER_URL、SAP_B1_DATABASE、SAP_B1_USERNAME、SAP_B1_PASSWORDが欠けている場合、プロセスは明確なメッセージで中止します。
エンティティ名は検証済み（^[A-Za-z][A-Za-z0-9_]*$）: パスの注入はできません（例: BusinessPartners/...）。
キー値とフィルタはODataでエスケープされます（一重引用符を二重化）: 'を含むidやItemCodeはURLや$filterを壊しません。
パスワードはMCPクライアントの設定に平文で残ります。リポジトリを共有する場合はシークレットマネージャーを検討してください。
npx github:にはsemverバージョン管理がありません。実行ごとにmainブランチの最新版を取得します。リポジトリを更新した後は、npm cache clean --forceを使用して再読み込みを強制してください。
実用的なヘキサゴナルアーキテクチャ（ESM、フレームワークなし）: ドメインとユースケースはMCPトランスポートやHTTPを認識しません。インフラストラクチャはServiceLayerPort（DIP）を実装し、MCPツールは薄いコントローラーです。
sap-b1-servicelayer-mcp/
├── package.json # Definición del paquete npm (bin: server.js)
├── server.js # Composition root: cablea dependencias y arranca stdio
├── src/
│ ├── config/
│ │ └── config.js # Configuración desde env, validada e inmutable
│ ├── domain/
│ │ ├── errors.js # Excepciones tipadas (Configuration/InvalidArgument/ServiceLayer)
│ │ ├── oData.js # Helpers puros: query string, filtros, clamp de $top, validación de entidad
│ │ └── edmx.js # Parseo puro de $metadata: entity sets, esquemas, function imports
│ ├── application/
│ │ ├── ports.js # Puerto ServiceLayerPort (contrato, DIP)
│ │ ├── helpers.js # ensureOk / ensureSuccess / unwrapValue
│ │ └── services/
│ │ ├── queryService.js # Consulta GET genérica a entidades OData
│ │ ├── catalogService.js # Socios de negocio y artículos (compone QueryService)
│ │ ├── salesService.js # Pedidos de venta y stock
│ │ ├── sessionService.js # Estado y cierre de sesión
│ │ ├── writeService.js # create / update / delete
│ │ ├── metadataService.js # Descubrimiento: $metadata cacheado, entidades, esquemas y actions
│ │ └── sqlService.js # SQL de solo lectura (SELECT/WITH) vía POST /sql_query
│ └── infrastructure/
│ ├── http/
│ │ ├── httpClient.js # Cliente HTTP mínimo (http/https)
│ │ ├── cookies.js # Manipulación pura de cookies de sesión
│ │ └── serviceLayerClient.js # Adaptador del puerto: login, 401, logout
│ └── mcp/
│ ├── result.js # ok / err / serialize / handle (controladores delgados)
│ └── tools.js # Registro de tools MCP
├── test/ # node:test (sin dependencias externas)
│ ├── config.test.js
│ ├── oData.test.js
│ ├── edmx.test.js # parseo EDMX v3/v4 (entity sets, esquemas, function imports)
│ ├── cookies.test.js
│ ├── client.test.js
│ ├── fakePort.js # fake tipado del puerto ServiceLayerPort (compartido)
│ ├── services.test.js # casos de uso con cliente fake (anti-inyección)
│ ├── metadataService.test.js # descubrimiento y acciones con fake
│ ├── sqlService.test.js # SQL solo-lectura (rechazos, Service Not Found)
│ └── tools.test.js # integración MCP in-memory (registro y llamadas)
├── .gitignore
└── README.mdサーバーは各インスタンスの$metadataに動的に適応し、ハードコードされたものはありません。実際のインスタンス（v1、OData v3）で検証された事実:
エンティティセットがEntityTypeを共有: Orders/Invoices/DeliveryNotes → SAPB1.Document。sap_get_entity_schemaは実際の型を自動的に解決します。
ドキュメント明細: v1では複合コレクション（DocumentLines、DocumentInstallments）であり、レスポンスにインラインで含まれます。$expandはnavigationPropertiesにのみ適用されます（スキーマにリストされます。例: BusinessPartner、Currency）。
財務フィールド: v1ではBusinessPartnersにBalanceはありません。CurrentAccountBalance、OpenOrdersBalance、OpenDeliveryNotesBalanceを使用します。請求書にはBalanceDueはありません。未収残高はDocTotal − PaidToDateです。
古いv1にはItemStockも/sql_queryもありません: sap_get_stockは検出された実際の在庫エンティティで通知します。sap_sql_queryは明確なエラーを返します。
v3のfunction importsでIsBindable="true"のものはboundとしてリストされ（単独では呼び出し不可）、sap_list_actionsを汚染しません。
SQLなし、sap_queryのみ（任意のv1/v2で動作）:
未払い請求書（多い場合はskipで200件以下のバッチにページング）:
sap_query('Invoices',
filter='PaidToDate lt DocTotal',
select='CardCode,CardName,DocNum,DocDate,DocDueDate,DocTotal,PaidToDate,DocumentStatus,ControlAccount')各請求書について: saldo = DocTotal − PaidToDate; días = 今日 − DocDueDate。
**0-30 / 31-60 / 61-90 / 90+**の範囲と顧客ごとにグループ化（または勘定科目ビューの場合はControlAccountごと）。
顧客/勘定科目ごとの合計: sap_get_business_partnersでCurrentAccountBalance（現在の残高）とCreditLimitを使用。
sap_sql_query（v2）を使用すると、同じレポートはOINV/OINV3/OFRJ/OCRDに対する単一のクエリになります。
npm install # dependencias
npm test # tests (node:test)
npm run typecheck # verificación de tipos estricta (tsc --noEmit sobre JSDoc)
npm start # arranque local (requiere variables de entorno)すべてのJSコードはJSDocを介して厳格なTypeScriptで検証されています（checkJs + strict + noUncheckedIndexedAccess）。tsconfig.jsonはビルドステップなしで、サーバーはnodeで直接実行されます。
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | \
SAP_B1_SERVER_URL=... SAP_B1_DATABASE=... SAP_B1_USERNAME=... SAP_B1_PASSWORD=... \
npx -y github:leonardows1/sap-b1-servicelayer-mcpThis server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors — no code.
Odoo ERP for AI agents: hosted OAuth endpoint, gated writes, one endpoint for every instance.
Connect your AI assistants to Keboola and expose your data, transformations, SQL queries, ...
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/leonardows1/sap-b1-servicelayer-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server