Personal Assistant MCP

🚀 Neuron MCP Server

This is a powerful and versatile personal assistant server that integrates multiple services, including Google Calendar, Obsidian Vault, Trello, and web page parsing capabilities.

🚀 Quick Start

The Neuron MCP Server is a multi - functional server integrating various services. It offers features like managing Google Calendar events, semantic search in Obsidian Vault, Trello task handling, and web page content extraction.

✨ Features

Integrated Services

• Google Calendar: Manage and synchronize calendar events.
• Obsidian Vault: Provide semantic search functionality, supporting vector retrieval (requires the Vector Search plugin to be installed).
• Trello: Handle kanban tasks and project management.
• Web Page Parser: Extract and parse web page content from a specified URL.

Core Features

• Modular Design: Each service runs independently, facilitating maintenance and expansion.
• Semantic Search: Conduct intelligent queries based on context understanding.
• Log Recording: Record operation logs for troubleshooting.

📦 Installation

Prerequisites

• Operating System: Linux or macOS is recommended. Additional configuration may be required for the Windows environment.
• Python Version: Python 3.8 or higher must be installed.
• Dependency Management Tool: Install Poetry for package management.

Installation Steps

1. Clone the code repository:

   git clone https://github.com/yourusername/neuron-mcp.git
   cd neuron-mcp
   

2. Install dependencies:

   poetry install
   

3. Configure environment variables:

   • Create and edit the .env file, filling in the corresponding API credentials and path information.

4. Start the service:

   poetry run start
   

📚 Documentation

Configuration Guide

Environment Variable Configuration Example (for Anthropic Claude Desktop)

# Example .env file content
GOOGLE_CREDENTIALS_PATH=/path/to/credentials.json
GOOGLE_TOKEN_PATH=/path/to/token.json
GOOGLE_API_KEY=your_api_key_here
GOOGLE_CX_ID=your_cx_id_here

OBSIDIAN_VAULT_PATH=/path/to/obsidian vault
OBSIDIAN_DEFAULT_FOLDER=/path/to/default folder
TRELLO_API_KEY=your_trello_api_key
TRELLO_TOKEN=your_trello_token
LOG_PATH=/path/to/logfile.log
SEMANTIC_SEARCH_ENABLED=True
SIMILARITY_THRESHOLD=0.5
EMBEDDINGS_PATH=/path/to/embeddings.json
MODEL_TOKEN_LIMIT=4096
CHUNK_SIZE_TOKENS=1024

Vector Search Plugin

To enable the semantic search function, install and configure the Vector Search plugin in Obsidian. After completing the plugin setup, an embedding file will be generated at .obsidian/plugins/vector-search/data.json.

Recommended Clients

• Anthropic Claude Desktop
• 5ire

Development Guide

Project Structure

• poetry: Used for dependency management.
• main.py: The main entry point for registering all tools and services.
• services/: Specific implementation modules for each service.

Contribution Process

1. Fork the code repository.
2. Create a feature branch:

   git checkout -b feature/your-feature-name
   

3. Commit changes and push to the remote repository:

   git commit -m 'Add or improve a certain feature'
   git push origin feature/your-feature-name
   

4. Submit a Pull Request.

🖼️ Image Example