Skip to main content
Glama
ACOMO MCP Server

ACOMO MCP Server

by progress-all

acomo-mcp-server

acomo API をツールから扱えるようにする MCP (Model Context Protocol) サーバです。stdio トランスポートで動作します。acomo の OpenAPI に基づく API 一覧やスキーマ参照、リクエスト雛形生成、API 呼び出し(問い合わせ)も行えます。

アーキテクチャ(MCP導入前/導入後)

以下は MCP 導入前と導入後のイメージ図です。

MCP導入前/導入後の構成イメージ

Related MCP server: yellow-pages

このサーバが提供するツールの種類

acomo MCP は、用途に応じて次の2種類のツールを提供します。

  • OpenAPI仕様に基づくAPIドキュメント応答ツール(仕様の検索・要約・雛形生成・Q&A/APIコールは行わない)

    • list_apis, describe_api, api_schemas, generate_request_template, list_components, describe_component

    • 認証や追加設定は不要です。

  • OpenAPI仕様に基づくAPIコールツール(API を実行)

    • call_api

    • 認証のため環境変数 ACOMO_TENANT_ID と ACOMO_ACCESS_TOKEN の設定が必要です。

MCP クライアント設定例(推奨: Docker)

以下は mcpServers 設定です(API仕様ドキュメント応答用途の例)。

{
  "mcpServers": {
    "acomo": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "ghcr.io/progress-all/acomo-mcp-server:latest"
      ]
    }
  }
}

latest イメージの更新(Docker)

latest タグのイメージを使っている場合、更新は次のコマンドで行えます。

docker pull ghcr.io/progress-all/acomo-mcp-server:latest

注: 既に起動中のコンテナは自動では更新されません。pull 後は旧コンテナを停止・削除して、改めて起動してください。

OpenAPI仕様に基づくAPIコールに必要な追加環境変数(callApi)

APIコールツールを使う場合は、次の環境変数が必要です。

  • ACOMO_TENANT_ID

  • ACOMO_ACCESS_TOKEN

Docker の設定例(上の応答用途の例に追記する形):

{
  "mcpServers": {
    "acomo": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "ACOMO_TENANT_ID=<tenant-id>",
        "-e", "ACOMO_ACCESS_TOKEN=<access-token>",
        "ghcr.io/progress-all/acomo-mcp-server:latest"
      ]
    }
  }
}

代替: GitHub からクローンして実行する場合(APIコール例)

Node.js 18+(推奨: 20+)

  1. リポジトリを取得してビルドします。

    git clone https://github.com/progress-all/acomo-mcp-server.git
    cd acomo-mcp-server
    npm ci
    npm run build
  2. mcpServers 設定(Node 実行・OpenAPI仕様に基づくAPIコールの例)

    {
      "mcpServers": {
        "acomo": {
          "command": "node",
          "args": ["/absolute/path/to/repo/dist/server.js"],
            "env": {
              "ACOMO_OPENAPI_PATH": "/absolute/path/to/repo/openapi.json",
              "ACOMO_TENANT_ID": "<tenant-id>",
              "ACOMO_ACCESS_TOKEN": "<access-token>"
            }
        }
      }
    }

提供ツール(Tools)

  • health: ヘルスチェック

  • list_apis: OpenAPI の API 一覧

  • describe_api: 指定 operationId の詳細(method/path/summary/raw に加え、baseUrlExample と completeUrl を含みます)

  • api_schemas: parameters / requestBody / responses の抜粋

  • generate_request_template: パラメータ・ボディの雛形生成(pathParams/query/body のスケルトン)

  • list_components: components.schemas の一覧

  • describe_component: 指定スキーマの JSON Schema

  • call_api: 指定 operationId で API 呼び出し(必要に応じて pathParams/query/body を受け付けます)

提供プロンプト(Prompts)

  • guide: acomo の前提と MCP の使い方をまとめたガイドを、acomo://guide リソースとともに返します(クライアントが MCP Prompts に対応している場合に利用可能)。

提供リソース(Resources)

  • acomo://guide: acomo MCP ガイド: 開発の前提・認証・MCPの使い方の要点(text/markdown)

使い方

基本的な使い方(例)

acomo APIの詳細を知らなくとも自然文で問い合わせできます。以下は Cursorでacomoのモデル一覧を取得してと実行した場合の例です。これは実際にacomoのAPIコールまで実行しています。

Cursor での利用例

開発中にacomo APIの詳細をAIに教えながらコーディングする場合はAPIコールなしでも使えます。以下は、Claude Codeでacomoのワークフローを開始する関数を書いてと実行した場合の例です。

Claude Code での利用例

MCP プロンプトの使い方(例)

guide プロンプトは acomo のコンセプトや前提をあらかじめ会話に読み込みます。単に自然文で問い合わせるよりも前提が揃った状態になるため、より高精度で一貫した回答を得やすく、毎回の前置き説明も不要になります。使い方はシンプルで、対応クライアントのプロンプト一覧から guide を実行するだけです(対応クライアントでは acomo://guide リソースも併せて表示されます)。

実行画面の例:

MCP プロンプトの使用例

補足: 表示される応答や生成コードの品質は、LLM のモデル特性やプロンプト、提供したコンテキストにより最適化されます。acomo MCP は OpenAPI 仕様の参照と安全な API 実行を担う標準インターフェースであり、各 LLM の強みを最大限に活かせるよう設計されています。

ライセンス

MIT License. 詳細は LICENSE を参照してください。

環境変数

変数名

必須/任意

既定値

用途/期待される値

ACOMO_TENANT_ID

APIコール時に必須

なし

acomo テナントID。callApi で x-tenant-id ヘッダとして送信されます。例: acomo-example

ACOMO_ACCESS_TOKEN

APIコール時に必須

なし

Bearer アクセストークン。callApi 時に Authorization: Bearer <token> を送信します。

ACOMO_API_BASE

任意

https://acomo.app

API のベースURL(ドメインのみを指定してください。/api/v1 等のパスは含めない)。例: http://localhost:3000

ACOMO_OPENAPI_PATH

任意

同梱 openapi.json(Docker イメージ内は /app/openapi.json)

読み込む OpenAPI 仕様ファイルのパス。通常は変更不要。

ACOMO_REQUEST_TIMEOUT_MS

任意

30000

リクエストタイムアウト(ミリ秒)。

参考

以下は、acomo 開発チームによる本 acomo MCP Server の開発背景と実装知見をまとめた技術ブログ記事です。

Available Tools

8 tools
api_schemasAPI schemasC

operationIdからparameters/requestBody/responsesを抜粋

Inputs: operationId (required).

call_apiCall APIC

operationIdを指定してAPIを呼び出す

Inputs: operationId (required), body, pathParams, query.

describe_apiDescribe APIC

operationIdの詳細(paths/method/要約/原文)を返す

Inputs: operationId (required).

describe_componentDescribe componentC

指定schema名の詳細(JSON Schema)を返す

Inputs: name (required).

generate_request_templateGenerate API request templateC

operationIdからpath/query/body雛形を生成

Inputs: operationId (required).

healthHealthB

acomo MCP server health check (fixed response)

Inputs: no named parameters.

list_apisList APIsB

acomoのAPI一覧を返す

Inputs: no named parameters.

list_componentsList componentsB

acomoのAPIスキーマ(components.schemas)の一覧を返す

Inputs: no named parameters.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: list_apis and list_components provide overviews, describe_api and describe_component give detailed information, api_schemas extracts specific parts, generate_request_template creates templates, call_api executes calls, and health checks server status. The descriptions make it easy to differentiate between listing, describing, extracting, generating, calling, and checking operations.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., list_apis, describe_api, call_api). The verbs (list, describe, generate, call, health) are clear and appropriately paired with nouns (apis, components, request_template, api), creating a predictable and readable naming convention throughout the set.

    Tool Count5/5

    With 8 tools, this server is well-scoped for its purpose of interacting with an API documentation system (acomo). Each tool serves a specific function in the workflow (listing, describing, extracting, generating, calling, and health checking), and none appear redundant or unnecessary, making the count appropriate for the domain.

    Completeness5/5

    The tool set provides complete coverage for the domain of API documentation exploration and interaction: it allows listing APIs and components, describing them in detail, extracting schemas, generating request templates, calling APIs, and checking server health. There are no obvious gaps, as it supports the full lifecycle from discovery to execution.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      Exposes two MCP tools (discover and execute) that enable agents to query an OpenAPI schema via natural language and execute matched API operations.
      2
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables API development directly from MCP clients by creating and editing collections, running requests through the real CLI, generating documentation, and starting mock servers.
      85 npm
      1
      MIT