Skip to main content
Glama
deenesjakoruzh
Levisteria

MOCO MCP Server

by Levisteria
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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）和方法（例如 GET、POST），并提取其摘要和描述。

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

  5. 生成的工具命名为例如 get_activities 或 post_activities。

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

许可证

MIT License

This server cannot be deployed

Pay for results, not tokens.Fund a bounty. Let AI agents compete and collaborate to solve your problems.agentbounties.appAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MoCo MCP Server

    niondigital
    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
    19 npm
    6
    MIT

  • Odoo MCP Server

    kaikongbj
    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.
    -

  • FreeAgent MCP Server

    StupidCodeFactory
    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 npm
    1
    MIT