Greg Elin gregelin

Troubleshooting MCP Server Launch Failures on M1 Mac (Claude Desktop Integration)

Context and Symptoms

When attempting to integrate a local MCP (Model Context Protocol) server with Anthropic’s Claude Desktop app on an M1 MacBook, users have encountered launch failures. In this scenario, the MCP server (written in Python 3.10–3.13 and run in a virtual environment) fails to start when Claude Desktop tries to connect to it. The Claude app’s logs repeatedly show an error message like:

Error: spawn uv ENOENT

Install GovReady-Q with IBM Trestle branding

The following are instructions for running GovReady local machine developer environment.

Reference

https://govready-q.readthedocs.io/en/latest/installation/development/index.html

Requirements

Python3

Install notes

changes

Install in venv instead of user specific python as described in docs

nginx

Remove default nginx site that takes priority handling requests with rm /etc/nginx/sites-enabled/default

ubuntu 20.04

Open Ubuntu's 20.04 default firewall to allow HTTP traffic to nginx with sudo ufw allow 'Nginx HTTP'

Installing GovReady-Q on Macintosh

Before you install

Your Mac will need to be running Python3 and some OS libraries for GovReady-Q's full features. Below are instructions for setting up your MacOS OS 10.14 or higher using Brew.

# install dependencies using brew
brew install python3

	<?xml version="1.0" encoding="UTF-8"?>
	<system-security-plan xmlns="http://csrc.nist.gov/ns/oscal/1.0"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="https://raw.githubusercontent.com/usnistgov/OSCAL/master/xml/schema/oscal_ssp_schema.xsd"
	uuid="2fa78e07-74ef-4cd6-8124-bc0050c0c4df">
	<metadata>
	<title>FedRAMP System Security Plan (SSP)</title>
	<published>2020-07-01T00:00:00.00-04:00</published>
	<last-modified>2020-07-01T00:00:00.00-04:00</last-modified>
	<version>0.0</version>

	>>> list = []
	>>> obj = {"k1": {"ks1":"vs1"},"k2": {"ks2":list}}
	>>> obj
	{'k1': {'ks1': 'vs1'}, 'k2': {'ks2': []}}
	>>> list.append({"ks3":"val"})
	>>> list
	[{'ks3': 'val'}]
	>>> obj
	{'k1': {'ks1': 'vs1'}, 'k2': {'ks2': [{'ks3': 'val'}]}}

	name: Django
	schema_version: 3.0.0
	documentation_complete: false
	satisfies:
	- control_key: AC-11
	control_name: Session Lock
	standard_key: NIST_SP-800-53_rev4
	covered_by: []
	security_control_type: Hybrid \| Inherited \| ...
	narrative:

	<html>
	<head>
	<style>
	body { padding-top:24px; font-size:24pt; text-align:center; border:8px solid green; }
	</style>
	<script>
	var i = 1; // set your counter to 1

	function myLoop() { // create a loop function
	setTimeout(function() { // call a 3s setTimeout when the loop is called

	{
	"component-definition": {
	"uuid": "7551cb7a-85d8-4f64-a8bc-056dc20bf16b",
	"metadata": {
	"title": "GovReady-Q Component-to-Control Narratives",
	"published": "2021-03-11T14:40:52+00:00",
	"last-modified": "2021-03-11T11:16:15+00:00",
	"version": "string",
	"oscal-version": "1.0.0-rc1"
	},

	# Following command runs `npm audit fix` in order to update `package-lock.json` and `yarn.lock` files in GovReady-Q
	docker exec -it frontend npm audit fix