MCP (Message Control Program) Servers

This repository contains a collection of MCP servers that provide interfaces to various services and APIs. Each server is designed to be used with Cursor IDE through symbolic links.

Structure

mcp/
├── AI_README.md        # Instructions for AI agents on Python best practices
├── README.md          # This file
├── github/           # GitHub API server
│   ├── server.py    # Main server implementation
│   └── ...
└── gmail/           # Gmail API server
    ├── server.py    # Main server implementation
    └── ...

Servers

GitHub Server

- Manages GitHub repositories - Handles SSH key authentication - Supports repository creation, deletion, and listing - Uses GitHub API tokens for enhanced functionality

Gmail Server

- Interfaces with Gmail API - Supports reading and sending emails - Uses OAuth 2.0 for authentication - Provides search functionality

Setup

Each server is symbolically linked to the Cursor IDE configuration directory:

~/.cursor/servers/github -> ~/mcp/github

~/.cursor/servers/gmail -> ~/mcp/gmail

Development

- All Python development follows the guidelines in AI_README.md
- Uses uv for Python package management
- Each server maintains its own virtual environment and dependencies

Security

- API tokens and credentials are stored securely
- OAuth 2.0 tokens are used where applicable
- Sensitive data is never committed to version control

Contributing

When adding a new MCP server:
1. Create a new directory in ~/mcp
2. Follow the Python project structure from AI_README.md
3. Create a symbolic link in ~/.cursor/servers
4. Update this README with server details

License

MIT License - Feel free to use and modify as needed.