Skip to main content
Glama
Sign In
enesjakozh

PeakMojo Server

Official
by peakmojo
GitHub
Python
MIT License
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Supports containerized deployment with multi-platform support for Linux/amd64, Linux/arm64, and Linux/arm/v7, allowing easy configuration via environment variables or command line arguments.

PeakMojo Server

A Python server implementation for integrating with the PeakMojo API.

Features

  • Full integration with PeakMojo API endpoints
  • Bearer token authentication
  • Resource and tool-based access to PeakMojo functionality
  • Automatic fallback to mock responses during development

Installation

pip install mcp-server-peakmojo

Configuration

The server requires the following environment variables:

You can also configure these via command line arguments:

python -m mcp_server_peakmojo --api-key YOUR_API_KEY --base-url YOUR_BASE_URL

Available Resources

The server provides access to the following PeakMojo resources:

  • Users (peakmojo://users)
  • Personas (peakmojo://personas, peakmojo://personas/tags, peakmojo://personas/search)
  • Scenarios (peakmojo://scenarios)
  • Job Scenarios (peakmojo://job_scenarios)
  • Jobs (peakmojo://jobs)
  • Applications (peakmojo://applications)
  • Practices (peakmojo://practices)
  • Skills (peakmojo://skills)
  • Certificates (peakmojo://certificates)

Available Tools

The server provides the following tools for interacting with the PeakMojo API:

User Management

  • get_peakmojo_users: Get list of all users
  • get_peakmojo_user: Get user details by ID
  • get_peakmojo_user_stats: Get user statistics
  • update_peakmojo_user_stats: Update user statistics

Persona Management

  • get_peakmojo_personas: Get list of personas
  • get_peakmojo_persona_tags: Get persona tags
  • search_peakmojo_personas: Search for personas
  • create_peakmojo_persona: Create a new persona

Scenario Management

  • get_peakmojo_scenarios: Get list of scenarios
  • create_peakmojo_job_scenario: Create a new job scenario

Workspace Management

  • get_workspace_personas: Get personas for a workspace

Job Management

  • get_job: Get job details

Application Management

  • get_application: Get application details

Practice Management

  • get_practice_messages: Get practice messages

Skill Management

  • get_user_skills: Get user skills

Certificate Management

  • get_certificates: Get list of certificates
  • get_certificate_skills: Get skills for a certificate
  • issue_user_certificate: Issue a certificate to a user
  • add_certificate_skill_courses: Add courses to a certificate skill

Development

During development, if the API is not accessible, the server will automatically fall back to mock responses for each endpoint. This allows for development and testing without requiring a live API connection.

Error Handling

The server implements comprehensive error handling:

  • Invalid API keys are logged with warnings
  • Failed API requests fall back to mock responses
  • HTTP errors are properly caught and logged
  • All errors are returned as JSON responses with appropriate error messages

Docker Support

Prerequisites

The Docker image is built for multiple platforms:

  • Linux/amd64
  • Linux/arm64
  • Linux/arm/v7

Option 1: Pull from Docker Hub

docker pull buryhuang/mcp-server-peakmojo:latest

Option 2: Build Locally

docker build -t mcp-server-peakmojo .

Running the Container

Basic usage with API key:

docker run \ -e PEAKMOJO_API_KEY=your_api_key_here \ -e PEAKMOJO_BASE_URL=https://api.staging.readymojo.com \ buryhuang/mcp-server-peakmojo:latest

Cross-Platform Publishing

To publish the Docker image for multiple platforms:

  1. Create a new builder instance (if you haven't already):
    docker buildx create --use
  2. Build and push the image for multiple platforms:
    docker buildx build --platform linux/amd64,linux/arm64,linux/arm/v7 -t peakmojo/mcp-server-peakmojo:latest --push .
  3. Verify the image is available for the specified platforms:
    docker buildx imagetools inspect peakmojo/mcp-server-peakmojo:latest

Usage with Claude Desktop

Configure the MCP server in your Claude Desktop settings:

{ "mcpServers": { "peakmojo": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "PEAKMOJO_API_KEY=your_api_key_here", "-e", "PEAKMOJO_BASE_URL=https://api.staging.readymojo.com", "peakmojo/mcp-server-peakmojo:latest" ] } } }

Example running from source

If you want to run directly from the source code:

{ "mcpServers": { "peakmojo": { "command": "python", "args": [ "-m", "mcp_server_peakmojo", "--api-key", "your_api_key_here", "--base-url", "https://api.staging.readymojo.com" ] } } }

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Python server implementation that enables integration with the PeakMojo API, providing access to various resources like users, personas, scenarios, and tools for managing PeakMojo functionality.

  1. Features
    1. Installation
      1. Configuration
        1. Available Resources
          1. Available Tools
            1. User Management
            2. Persona Management
            3. Scenario Management
            4. Workspace Management
            5. Job Management
            6. Application Management
            7. Practice Management
            8. Skill Management
            9. Certificate Management
          2. Development
            1. Error Handling
              1. Docker Support
                1. Prerequisites
                2. Option 1: Pull from Docker Hub
                3. Option 2: Build Locally
                4. Running the Container
                5. Cross-Platform Publishing
                6. Usage with Claude Desktop
                7. Example running from source
              2. Contributing

                Related Resources

                Related MCP Servers

                • Lodestar MCP Server

                  kanlanc
                  -
                  security
                  F
                  license
                  -
                  quality
                  This is an MCP server that facilitates building tools for interacting with various APIs and workflows, supporting Python-based development with potential for customizable prompts and user configurations.
                  Last updated -
                  Python

                • Blender MCP Server

                  cwahlfeldt
                  -
                  security
                  F
                  license
                  -
                  quality
                  A Model Context Protocol server that allows management and execution of Blender Python scripts, enabling users to create, edit and run scripts in a headless Blender environment through natural language interfaces.
                  Last updated -
                  4
                  Python

                • Nash MCP Server

                  nash-app
                  -
                  security
                  A
                  license
                  -
                  quality
                  A Model Context Protocol server that enables seamless execution of commands, Python code, web content fetching, and reusable task management with secure credentials handling.
                  Last updated -
                  2
                  Python
                  MIT License
                  • Apple

                • MCP Server for continue.dev

                  alexsmirnov
                  A
                  security
                  F
                  license
                  A
                  quality
                  A Python server implementing the Model Context Protocol to provide customizable prompt templates, resources, and tools that enhance LLM interactions in the continue.dev environment.
                  Last updated -
                  2
                  Python

                View all related MCP servers

                New MCP Servers

                ID: ruy01d9rky