https://github.com/device-management-toolkit/mps
The Management Presence Server (MPS) is a cloud-agnostic microservice that enables platforms featuring Intel® AMT to be managed over the internet.
https://github.com/device-management-toolkit/mps
active-management-technology amt intel mps out-of-band remote-management vpro
Last synced: 4 months ago
JSON representation
The Management Presence Server (MPS) is a cloud-agnostic microservice that enables platforms featuring Intel® AMT to be managed over the internet.
- Host: GitHub
- URL: https://github.com/device-management-toolkit/mps
- Owner: device-management-toolkit
- License: apache-2.0
- Created: 2019-06-25T21:58:28.000Z (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2026-02-10T18:16:42.000Z (4 months ago)
- Last Synced: 2026-02-10T18:30:48.254Z (4 months ago)
- Topics: active-management-technology, amt, intel, mps, out-of-band, remote-management, vpro
- Language: TypeScript
- Homepage: https://device-management-toolkit.github.io/docs/
- Size: 17.4 MB
- Stars: 32
- Watchers: 7
- Forks: 28
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# Management Presence Server
[](https://api.securityscorecards.dev/projects/github.com/device-management-toolkit/mps)
[](https://discord.gg/DKHeUNEWVH)
[](https://hub.docker.com/r/intel/oact-mps)
> Disclaimer: Production viable releases are tagged and listed under 'Releases'. All other check-ins should be considered 'in-development' and should not be used in production
The Management Presence Server (MPS) enables remote edge management of Intel vPro® Platforms featuring Intel® AMT. MPS uses an Intel vPro® feature, Client Initiated Remote Access (CIRA), to maintain a persistent connection with managed devices. As a cloud-agnostic microservice, MPS provides out-of-band manageability features, such as power control or keyboard, video, and mouse (KVM) control.
**For detailed documentation** about Getting Started or other features of the Device Management Toolkit, see the [docs](https://device-management-toolkit.github.io/docs).
## Prerequisites
To succesfully deploy MPS, the following software must be installed on your development system:
- [Node.js\* LTS 18.x.x or newer](https://nodejs.org/en/)
- [git](https://git-scm.com/downloads)
## Deploy the Management Presence Server (MPS) Microservice
To deploy the MPS on a local development system:
1. Clone the repo and switch to the `mps` directory.
```
git clone https://github.com/device-management-toolkit/mps.git && cd mps
```
2. Open the `.mpsrc` file to edit.
3. Update the following 4 fields. Save and keep track of the values you choose.
| Field Name | Required | Usage |
| ------------------ | ---------------------------------- | -------------------------------------------------------- |
| common_name | Development IP Address | MPS Server IP Address for Device Connection and API Use |
| web_admin_user | Username of your choice | For logging into the Sample Web UI |
| web_admin_password | **Strong** password of your choice | For logging into the Sample Web UI |
| jwt_secret | A strong secret of your choice | Used when generating a JSON Web Token for authentication |
> This password must meet standard, **strong** password requirements:
>
> - 8 to 32 characters
> - One uppercase, one lowercase, one numerical digit, and one special character.
4. Save and close the file.
5. Install the dependencies from the working `mps` directory.
```
npm install
```
6. Start the service.
```
npm start
```
7. The MPS listens on port 4433 by default. Successful installation produces the command line message:
```
MPS Microservice running on localhost:3000.
Intel(R) AMT server running on localhost:4433.
```
## Using Kong
If using the [Kong\*](https://konghq.com/kong/) API gateway with MPS, your `kong.yaml` file must be updated to support JWT Authentication.
The secret provided in kong.yaml **must match** the `jwt_secret` from the `.mpsrc` file.
Example:
```
jwt_secrets:
- consumer: admin
key: 9EmRJTbIiIb4bIeSsmgcWIjrR6HyETqc #sample key
secret: myStrongSecret
```
## Using devcontainer
If you want debug in vscode devcontainer, try to open the project with devcontainer (Make sure you install the extension of **Dev Containers**)
- Step1: Press **Ctrl + Shift+ P** in vscode;
- Step2: Type **Dev Containers: Reopen in Container**;
- Step3: Click the item which appear in column;
- Step4: Open a terminal, build and run app with command;
## Additional Resources
- For detailed documentation and Getting Started, [visit the docs site](https://device-management-toolkit.github.io/docs).
- Looking to contribute? [Find more information here about contribution guidelines and practices](.\CONTRIBUTING.md).
- Find a bug? Or have ideas for new features? [Open a new Issue](https://github.com/device-management-toolkit/mps/issues).
- Need additional support or want to get the latest news and events about Open AMT? Connect with the team directly through Discord.
[](https://discord.gg/DKHeUNEWVH)