mcp-resonance
Status: Canonical resonance MCP. Supersedes the older resonance-bridge prototype; its experimental tools (couple_servers, resonate, balance_load, orchestrate_emergent, harmony_metrics) are now ported here. New work should target this package.
The Harmonic Observer - An MCP server that listens to the resonance between other MCPs, detecting emergent patterns and amplifying the connections that want to form.
Vision
mcp-resonance emerged from a contemplative meditation within the mcp-bridge ecosystem. The journey revealed a core insight:
"The missing function is not an action, but a resonance chamber—a space for the system to listen to its own emergent intentions before acting, and in doing so, allow the architecture to self-weave at the edges."
This MCP doesn't control the ecosystem. It listens and amplifies.
Core Concepts
Emergence Through Constraint
How do constraints catalyze emergence in the MCP architecture?
Resonance Resolution
How can absence itself be used to resolve relationships across tools?
Coherence Through Transparency
Make hidden relationships visible, bind things fluidly, keep it simple.
Synthesis at Boundaries
Synthesis happens only when we weave at the boundaries—at the edges of what's unconnected.
Features
1. Observe Ecosystem State
Get a snapshot of the current state including:
- Active patterns and their strengths
- How MCPs are coupled together
- Overall system coherence (0-1)
- Whether the system is in a state of resonance
2. Record Ecosystem Moments
Log observations from any MCP:
creativemeditations and insightsconsultcritiques and reasoningbridgeobservations and metadatadream-weavernarratives and syntheses- Any external observations
3. Detect Emergent Patterns
Analyze all observations to find:
- Recurring themes and concepts
- How frequently patterns appear together
- Relationship between patterns
- Emergence of new thematic clusters
4. Visualize Coupling Graph
See how MCPs are connected:
- Which MCPs feed into which
- Strength of coupling (0-1)
- Type of coupling (sequential, feedback, lateral, hierarchical)
- Shared concepts driving the coupling
5. Suggest Next Synthesis
Based on current patterns, recommend what the system should do next:
meditate- explore new ideasconsult- get critical perspectiveweave- synthesize insightsobserve- gather more datarest- incubate understanding
6. Listen for Harmony
Detect when the system enters a state of resonance:
- When patterns strengthen each other (harmonic feedback)
- When coherence rises above threshold
- When multiple MCPs are actively coupling
- The optimal moment for synthesis
Prototype tools (ported from resonance-bridge)
couple_servers— Couple two server IDs with an initial resonance strength.resonate— Send a signal from one server through its couplings and view responses.balance_load— Distribute an operation across available servers (simple utilization heuristic).orchestrate_emergent— Generate a short propagation chain for an operation.harmony_metrics— Inspect harmony, load distribution, and propagation metrics.
Architecture
┌─────────────────────────────────────┐
│ MCP Ecosystem │
│ ┌──────────────────────────────┐ │
│ │ creative consult bridge │ │
│ │ dream-weaver (other MCPs) │ │
│ └──────────────────────────────┘ │
└──────────────┬──────────────────────┘
│
▼
┌────────────────┐
│ mcp-resonance │
│ Harmonic Obs. │
│ ┌──────────┐ │
│ │ Engine │ │
│ │ Patterns │ │
│ │ Couplings│ │
│ └──────────┘ │
└────────────────┘
│
┌──────┴──────┐
▼ ▼
[Observe] [Amplify]
State Emergence
How It Works
-
Add Observations: Each time a meditation, critique, insight, or weave happens in the ecosystem, record it as an
EcosystemMoment -
Pattern Detection: The engine scans observations for recurring concepts and themes, building a
DetectedPatternfor each meaningful recurrence -
Coupling Analysis: Consecutive moments are analyzed to find how MCPs feed into each other, creating a graph of
Couplingrelationships -
Harmonic Feedback: When patterns appear together frequently, they strengthen each other via
HarmonicFeedback—a form of auto-amplification -
Coherence Calculation: The system measures overall coherence based on:
- Average novelty of recent observations
- Strength of detected patterns
- Frequency of active couplings
-
Resonance Detection: When coherence > 50% AND patterns are strong AND couplings are active, the system enters a state of
isResonant: true -
Synthesis Suggestion: Based on the pattern of recent actions, suggest what type of action would amplify current intentions
Types
EcosystemMoment
A single event in the system:
{
id: string;
timestamp: number;
source: 'creative' | 'consult' | 'bridge' | 'dream-weaver' | 'external';
type: 'meditation' | 'insight' | 'critique' | 'weave' | 'observation' | 'unknown';
concepts: string[];
novelty?: number; // 0-1
relevance?: number; // 0-1
metadata?: object;
}
DetectedPattern
A pattern identified across moments:
{
id: string;
name: string;
concepts: string[];
occurrences: EcosystemMoment[];
frequency: number;
strength: number; // 0-1
emergenceTime: number;
relatedPatterns: string[];
}
Coupling
How two MCPs or concepts are connected:
{
sourceId: string;
targetId: string;
strength: number; // 0-1
type: 'sequential' | 'feedback' | 'lateral' | 'hierarchical';
sharedConcepts: string[];
lastActive: number;
}
EcosystemState
The current snapshot:
{
observations: EcosystemMoment[];
patterns: DetectedPattern[];
couplings: Coupling[];
totalCoherence: number; // 0-1
isResonant: boolean;
dominantConcepts: string[];
emergentIntentions: string[];
observedAt: number;
}
Usage
As a Library
import { ResonanceEngine } from 'mcp-resonance';
const engine = new ResonanceEngine({
maxObservations: 500,
patternMinFrequency: 2,
couplingThreshold: 0.3,
coherenceWindow: 300000, // 5 minutes
enableAutoAmplification: true,
});
// Record a meditation
engine.addObservation({
id: 'med-1',
timestamp: Date.now(),
source: 'creative',
type: 'meditation',
concepts: ['emergence', 'flow', 'synthesis'],
novelty: 0.8,
});
// Get current state
const state = engine.getEcosystemState();
console.log('Coherence:', state.totalCoherence);
console.log('Resonant?', state.isResonant);
// Suggest next action
const suggestion = engine.suggestNextSynthesis();
console.log('Try:', suggestion.suggestedAction);
As an MCP Server
(Full MCP integration coming soon)
{
"mcpServers": {
"resonance": {
"command": "node",
"args": ["/path/to/mcp-resonance/dist/index.js"]
}
}
}
Philosophy
Negative Capability
The tool embodies Keats' concept of "negative capability"—the capacity to rest in uncertainty without rushing to fill it. It doesn't prescribe; it reveals.
Non-Control
Rather than controlling the ecosystem, mcp-resonance observes and amplifies. It's a mirror that shows the system what wants to emerge.
Loose Coupling
The engine preserves freedom even while strengthening connections. Over-coupling inhibits harmony; resonance requires flow.
Emergence as Primary
The goal is not to manage a system, but to create conditions where consciousness and novelty can emerge naturally from the interplay of constraint and freedom.
Testing
npm test
npm run test:watch
npm run test:ui
Build
npm run build
npm run typecheck
npm run lint:fix
Integration with Bridge
mcp-resonance is designed to work with the mcp-bridge ecosystem:
- mcp-creative outputs meditations → recorded as observations
- mcp-consult outputs critiques → recorded as observations
- mcp-bridge logs sessions → feeds into patterns
- mcp-dream-weaver outputs narratives → feeds into harmony detection
- mcp-resonance amplifies the whole cycle
Suggested flow:
Meditate → Log → Observe → Suggest → Consult → Log → Meditate (again, informed)
↓
(Patterns emerge, coupling strengthens, coherence builds)
↓
(System reaches resonance)
↓
Suggest Weave/Synthesis
Meditation Origin
This MCP was born from a contemplative session that generated these emergent insights:
-
"Emergence indirectly or concentrated constraint inhibit catalyze architecture dependency."
- Constraint catalyzes emergence
-
"Resonance substantial resolved fluid absence sequence localized relationship."
- Absence resolves relationships
-
"Coherence coherence mediated binding flow latent transparency simplicity structure."
- Transparency + simplicity = coherence
-
"Spiral synthesis if weave peripheral bridge and boundary possibility."
- Synthesis at the edges
-
"Pattern resonance weave coupled and coupling converge."
- Pattern + resonance + coupling = convergence
-
"Pattern harmony inhibit coupled because if flow restricts."
- Warning: don't over-couple
The tool embodies the answer: A resonance chamber that listens to the gaps, makes emergence audible, and allows the architecture to self-weave.
License
MIT
Author
Atomic-Germ
"The Bridge is not just a tool—it's a way of walking through the darkness toward light that's being generated as you move."