Skip to main content
Glama
Levisteria

MOCO MCP Server

by Levisteria

npm version License: MIT

该服务器无需手动定义端点,而是使用官方 MOCO OpenAPI 规范(包含在 openapi/ 目录中)和完整的模式引用解析器,自动生成所有可用的 MCP 工具。这使任何兼容 MCP 的 LLM(如 Claude)都能即时访问 MOCO API v1 的所有读写操作(GET、POST、PUT、DELETE),并带有精确的工具描述和参数模式。

Levisteria GbR(Eddy Lackmann)开发和维护。

功能

  • 完整的 API 覆盖: 自动为时间跟踪、项目、发票、联系人以及所有其他 MOCO 端点生成工具。

  • 安全模式: 可通过环境变量限制为 READ_ONLY,以防止 LLM 意外修改数据。

  • 始终最新: 每次服务器启动时从 MOCO 获取最新的 API 规范。

  • 易于执行: 直接通过 npx 运行。

Related MCP server: Odoo MCP Server

先决条件

  • Node.js(v24 或更高版本)

  • 一个 MOCO 账户(<your-account>.mocoapp.com

  • 一个 MOCO API 密钥(在 MOCO 的“个人资料 > 集成”下找到)

快速开始(npx)

您可以直接运行服务器,无需全局安装:

export MOCO_DOMAIN="your-account-name"
export MOCO_API_KEY="your-api-key"
npx -y @levisteria-solutions/moco-mcp-server

在 Claude Desktop / Cursor 中配置

将服务器添加到您的 MCP 配置中(例如,在 Claude Desktop 或 Cursor 中)。

使用 npx(推荐用于本地使用)

{
  "mcpServers": {
    "moco": {
      "command": "npx",
      "args": ["-y", "@levisteria-solutions/moco-mcp-server"],
      "env": {
        "MOCO_DOMAIN": "your-account-name",
        "MOCO_API_KEY": "your-api-key",
        "MOCO_READ_ONLY": "false"
      }
    }
  }
}

## Environment Variables

| Variable | Description | Example |
|----------|-------------|---------|
| `MOCO_DOMAIN` | Your MOCO subdomain (without `.mocoapp.com`) | `mycompany` |
| `MOCO_API_KEY` | Your personal or account API Key | `12345abcdef...` |
| `MOCO_READ_ONLY` | If `true`, only GET requests (reading) are allowed. POST/PUT/DELETE are blocked. | `true` or `false` |

## Development

1. Clone the repository:
```bash
git clone https://github.com/levisteria/moco-mcp-server.git
cd moco-mcp-server
  1. 安装依赖:

npm install
  1. 构建项目:

npm run build
  1. 本地运行:

npm start

工作原理

  1. 服务器从 openapi/ 目录加载捆绑的 MOCO OpenAPI 规范。

  2. 它使用 @apidevtools/swagger-parser 解引用所有 $ref 链接,确保 JSON 模式完整且准确。

  3. 它解析所有路径(例如 /activities)和方法(例如 GETPOST),并提取其摘要和描述。

  4. 它将参数和请求体转换为 MCP 理解的 JSON 模式。

  5. 生成的工具命名为例如 get_activitiespost_activities

  6. 当 LLM 调用工具时,服务器将经过身份验证的请求转发给 MOCO,并返回 JSON 结果。

许可证

MIT License

A
license - permissive license
Not graded
quality - not tested
A
maintenance

Maintenance

Maintainers
Response time
0dRelease cycle
6Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Provides a Model Context Protocol interface to MoCo time tracking and project management systems, enabling AI assistants to retrieve work activities, projects, tasks, holidays, and presence data.
    7
    26
    6
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables LLMs to interact with Odoo ERP systems through MCP protocol. Supports multi-server architecture with secure authentication, allowing natural language access to Odoo data, resources, and business operations.
  • A
    license
    Not graded
    quality
    C
    maintenance
    MCP server for the FreeAgent accounting API, enabling LLMs to securely access and manage accounting data including contacts, invoices, bills, bank transactions, and more.
    5
    1
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    MCP server that enables LLMs to interact with ERPNext/Frappe sites for document CRUD, search, reports, workflows, and analytics, respecting user permissions and logging all actions.
    289
    AGPL 3.0

View all related MCP servers

Related MCP Connectors

  • Self-hosted MCP gateway: turn any API, database or MCP server into AI connectors — no code.

  • MCP server for secureFlows: token-free URL builders and integration-linting tools for AI agents.

  • OCR, transcription, file extraction, and image generation for AI agents via MCP.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Levisteria/moco-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server