Claude Desktop API USE VIA MCP

🚀 Implementation of Integrating Claude Desktop API via MCP

This project offers an MCP server implementation, enabling seamless integration between Claude Desktop and Claude API. It allows you to bypass professional plan restrictions and access advanced features, such as custom system prompts and conversation management.

✨ Features

• Integrate Claude API directly via MCP.
• Track and manage conversation history.
• Support system prompts.
• Seamlessly switch between professional plan and API usage.
• Simple configuration with Claude Desktop.

📋 Use Cases

• Professional Plan (default):
  • Conduct regular conversations in Claude Desktop.
  • Perform basic usage within the plan's limits.
  • No special configuration required.
• API Token (via this MCP server):
  • When a longer context window is needed.
  • To use custom system prompts.
  • To bypass rate limits.
  • For advanced conversation management.

📦 Installation Guide

1. Clone the repository

   # Using VS Code:
   # 1. Press Cmd + Shift + P
   # 2. Type "Git: Clone"
   # 3. Paste: https://github.com/mlobo2012/Claude_Desktop_API_USE_VIA_MCP.git
   
   # Or using the terminal:
   git clone https://github.com/mlobo2012/Claude_Desktop_API_USE_VIA_MCP.git
   cd Claude_Desktop_API_USE_VIA_MCP
   

2. Install dependencies

   pip install -r requirements.txt
   

3. Configure the environment

   # Copy the environment variable template
   cp .env.example .env
   
   # Edit .env and add your API key
   ANTHROPIC_API_KEY=your_api_key_here
   

4. Configure Claude Desktop
   • macOS: Navigate to ~/Library/Application Support/Claude/

     # Using Finder:
     # 1. Press Cmd + Shift + G
     # 2. Type: ~/Library/Application Support/Claude/
     

   • Windows: Navigate to %APPDATA%\Claude\
   • Create or edit claude_desktop_config.json
   • Copy the contents from config/claude_desktop_config.json
   • Update the paths and API key

💻 Usage Examples

Basic Usage

1. Regular use of Claude Desktop
   • Chat with Claude as normal.
   • Perform basic operations within the professional plan.
   • No special configuration required.
2. Use Claude API via the MCP server
   • After configuration, start the MCP server.
   • Invoke API functions using Claude Desktop.
   • Follow the examples in the documentation.

Advanced Usage

• Custom system prompts:
  • Edit config/system_prompt.json.
  • Add or modify prompt content.
  • Restart the service to apply changes.
• Conversation history management:
  • Use the provided API to query and manage conversation records.
  • Support filtering by time, topic, etc.
  • Provide detailed conversation context.

🔧 Technical Details

Code Structure

• server.py: The main program of the MCP server.
• config/: Directory for configuration files.
• utils/: Module for utility functions.
• prompts/: Templates for system prompts.

Contribution Guidelines

• Submit issues or suggestions to the GitHub repository.
• Create a feature branch for development.
• Submit a Pull Request.

🛠️ Troubleshooting

Common Issues

• Unable to start the server:
  • Check if the API key is correctly configured.
  • Ensure all dependencies are installed.
  • Check the error log for more information.
• Conversation records are lost:
  • Check the database connection settings.
  • Ensure the storage directory has correct permissions.
  • Check the service log to confirm if the record function is working properly.

Contact Information

For help or feedback, please visit the Issues page of the GitHub repository, or refer to the discussion area and troubleshooting guide.