RegCoding/emotionsin_ai_mcp

Emotionsin.ai – MCP Server (Open Source)

Welcome to the Emotionsin.ai MCP Server — an open-source foundational MCP (Model Context Protocol) server designed to give every Emotionsin.ai user the ability to integrate emotional profiles into any LLM-driven chatbot or AI agent.

This repository provides a lightweight, extensible server that exposes:

• A user-specific Emotionsin.ai emotional profile
• A framework to add custom MCP tools for personality shaping, immersive interactions, and context-adaptive AI behaviors

The goal: enable developers and creators to build deeply personalized, emotionally intelligent conversational agents using a fully open, modular, and MIT-licensed MCP server.

✨ Features

• Open Source MCP Server (MIT License)
• Emotionin.ai Profile Integration
  Fetch and use a customer-specific emotional profile from https://emotionsin.ai.
• Custom Tool Extensibility
  Add your own MCP tools to tailor the LLM's emotional expression, personality traits, or domain-specific behavior.
• Dockerized Deployment
  Fully configured Docker container for local or cloud operation.
• Minimal Installation Requirements
  requirements.txt includes all necessary dependencies for easy setup.
• Developer-friendly Architecture
  Clean, modular codebase designed to be extended or embedded into larger agent frameworks.

📌 Purpose of This Project

Emotionin.ai provides emotional and personality profiling services.

This MCP server acts as a bridge that exposes such a profile to any MCP-enabled LLM client (ChatGPT, open-source LLM frontends, custom agents, etc.).

Developers can:

• Build AI agents that respond differently depending on the user's emotional profile
• Add custom logic, memory tools, context fetchers, API utilities, or domain-specific knowledge tools
• Shape the agent's tone, style, empathy, and interaction patterns
• Create fully immersive, personalized experience layers powered by the Emotionin.ai ecosystem

🏗️ Architecture Overview

┌──────────────────────────┐
│ Emotionsin.ai Profile    │ (external service: https://emotionsin.ai)
└───────────────┬──────────┘
                │
                │ Fetch emotional profile
                │
┌───────────────▼───────────┐
│ MCP Server Core           │ (This repository)
│ - Profile retrieval tool  │
│ - Extensible MCP handlers │
└───────────────┬───────────┘
                │
                │ Custom Tools Added by Devs
                │
┌───────────────▼─────────────┐
│ LLM / Chatbot Client        │
└─────────────────────────────┘

📦 Installation

Prerequisites

• Docker (optional but recommended)
• Python 3.9+ (if running without Docker)

🚀 Quick Start

Docker (Recommended)

This repository includes a preconfigured Dockerfile for fast setup.

docker build -t emotionin-mcp-server .
docker run -p 3000:3000 emotionin-mcp-server

Manual Installation

git clone https://github.com/RegCoding/emotionsin_ai_mcp.git
cd emotionsin_ai_mcp
pip install -r requirements.txt
python mcp_server.py

🧩 Adding Custom MCP Tools

This MCP server is intentionally minimal, giving developers freedom to add tools such as:

• Personality modifiers
• Domain knowledge injectors
• User memory systems
• Context APIs (calendar, CRM, IoT, etc.)
• Emotional tone controllers

🔐 Emotionin.ai Service Attribution Requirement

This project is MIT-licensed (see below).

If you use or distribute this MCP server, you must include attribution that it uses the Emotionin.ai emotional profile service (https://emotionsin.ai).

Example attribution:

"This custom MCP server uses an Emotionsin.ai emotional profile (https://emotionsin.ai)."

This is the only requirement beyond standard MIT terms.

🤝 Contributing

Contributions are welcome!

1. Fork the repository
2. Create a feature branch
3. Open a pull request

🙋 Support

• For Emotionin.ai profile services or integration questions:
  https://emotionsin.ai

• For issues with the MCP server code:
  Open an issue in this repository.

⭐ If you find this useful…

Give the repository a star — it helps others discover the project!

📄 License

MIT License - See LICENSE file for details.

If you want, I can also generate:

• A downloadable .md file
• CONTRIBUTING.md
• A template /tools example
• A logo/banner for the repo

Just tell me!