GitHub - edgee-cloud/mcp-server-edgee (original) (raw)

Edgee MCP Server

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": "" } } } }

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