Edgee MCP Server

What is Edgee MCP Server about?

Edgee MCP Server offers a set of TypeScript‑based APIs and CLI tools that let developers create, read, update, and delete organizations, projects, components, and users. It serves as a backend for the Edgee platform, exposing operations through the Model Context Protocol.

How to use Edgee MCP Server?

1. Install – the recommended way is to run the server with npx:

   npx -y @edgee/mcp-server-edgee
   

2. Configure – supply an Edgee personal access token via the environment variable EDGEE_TOKEN.
3. Integrate – add the server definition to claude_desktop_config.json (or any MCP‑compatible client) and invoke the provided tools such as edgee-listOrganizations, edgee-createProject, etc.

Key Features

• Full CRUD for organizations, projects, domains, components, and users.
• Specialized CLI commands for common tasks (listing, creating, updating, deleting).
• Detailed error handling with clear messages.
• Type‑safe API written in TypeScript.
• Support for API tokens, invitations, and presigned upload URLs.
• Built‑in statistics and counters for projects.

Use Cases

• Automating onboarding of new organizations and projects in CI/CD pipelines.
• Managing component libraries and versioning across multiple teams.
• Integrating user and permission management into internal admin dashboards.
• Generating presigned URLs for secure file uploads.
• Collecting project usage metrics for reporting.

FAQ

Q: Which command should I use to run the server? A: Use npx -y @edgee/mcp-server-edgee for the simplest experience.

Q: How do I authenticate the server? A: Set the environment variable EDGEE_TOKEN to a personal access token created in your Edgee account.

Q: Can I install the server globally? A: Yes, npm install -g @edgee/mcp-server-edgee works, but npx is recommended.

Q: What programming language is the API written in? A: The server is implemented in TypeScript, providing strong type safety.

Q: Are there any rate limits? A: Rate limits are defined by the Edgee platform; refer to the Edgee documentation for details.

MCP Server for the Edgee API, enabling organization management, project operations, component management, and user administration through the Model Context Protocol.

Features

• Organization Management: Create, read, update, and delete organizations
• Project Operations: Manage projects, domains, components, and statistics
• Component Management: Work with components, versions, and settings
• User Administration: Manage users, invitations, and API tokens
• Comprehensive Error Handling: Clear error messages for common issues
• Type-Safe API: Built with TypeScript for robust type checking

Tools

Organization Tools

• edgee-listOrganizations: List all organizations with optional filtering
• edgee-getMyOrganization: Get your personal organization
• edgee-getOrganization: Get an organization by ID
• edgee-createOrganization: Create a new organization
• edgee-updateOrganization: Update an existing organization
• edgee-deleteOrganization: Delete an organization
• edgee-listOrganizationUsers: List users of an organization

Project Tools

• edgee-listProjects: List all projects with optional filtering
• edgee-getProject: Get a project by ID
• edgee-createProject: Create a new project
• edgee-updateProject: Update an existing project
• edgee-deleteProject: Delete a project
• edgee-getProjectCounters: Get statistics for a project
• edgee-listProjectDomains: List domains for a project
• edgee-createProjectDomain: Create a new domain for a project
• edgee-listProjectComponents: List components for a project

Component Tools

• edgee-listPublicComponents: List all public components
• edgee-listOrganizationComponents: List components for an organization
• edgee-getComponentByUuid: Get a component by UUID
• edgee-getComponentBySlug: Get a component by slug
• edgee-createComponent: Create a new component
• edgee-createComponentVersion: Create a new component version

User Tools

• edgee-getMe: Get the current user
• edgee-getUser: Get a user by ID
• edgee-listInvitations: List all invitations
• edgee-createInvitation: Create a new invitation
• edgee-deleteInvitation: Delete an invitation
• edgee-listApiTokens: List all API tokens
• edgee-createApiToken: Create a new API token
• edgee-deleteApiToken: Delete an API token
• edgee-getUploadPresignedUrl: Get a presigned URL for uploading files

Setup

Personal Access Token

Create an Edgee Personal Access Token:

• Go to API tokens (in Account Settings > API Tokens)
• Create a token
  • Give a name to this token
  • Select a validity period of the token you're about to create. If no duration is selected, the token will never expire.
• Copy the generated token

Installation

You can use this MCP server in several ways:

NPX (Recommended)

npx @edgee/mcp-server-edgee

Global Installation

npm install -g @edgee/mcp-server-edgee

Local Installation

npm install @edgee/mcp-server-edgee

Usage with Claude Desktop

To use this with Claude Desktop, add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "edgee": {
      "command": "npx",
      "args": [
        "-y",
        "@edgee/mcp-server-edgee"
      ],
      "env": {
        "EDGEE_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Examples

List Organizations

Use the edgee-listOrganizations tool to list all your organizations.

Create a Project

Use the edgee-createProject tool to create a new project with the following parameters:
- organization_id: "org_123456"
- slug: "my-new-project"
- description: "This is my new project"

Get Project Components

Use the edgee-listProjectComponents tool to list all components for project "proj_123456".

Create an Invitation

Use the edgee-createInvitation tool to invite a user to your organization:
- organization_id: "org_123456"
- email: "user@example.com"
- role: "member"

Development

Building from Source

git clone https://github.com/edgee-cloud/mcp-server-edgee.git
cd mcp-server-edgee
npm install
npm run build

License

Apache-2.0