Custom MCP Server

🚀 Custom MCP Server

A custom Machine Conversation Protocol (MCP) server integrating various tools for AI assistants, which can solve the problem of limited functionality of traditional servers and provide a more comprehensive and efficient service for AI assistants.

🚀 Quick Start

# Clone the repository
git clone https://github.com/degenhero/custom-mcp-server.git
cd custom-mcp-server

# Install dependencies and set up the environment
npm run install:all

# Start both servers
npm run start:both

The servers will run at:

• MCP Server: http://localhost:3000
• MCP Protocol Server: http://localhost:3001

💻 Usage Examples

Using with Claude

To use this custom MCP server with Claude, install it as an MCP server:

npx @anthropic-ai/install-mcp custom-mcp-server http://localhost:3001

After installation, Claude will be able to access all the features provided by the server.

🔧 Technical Details

Architecture

The project consists of two main components:

1. Custom MCP Server (index.js) - The core server that implements all tool functions.
2. MCP Protocol Server (mcp-protocol.js) - Adapts the custom server to the MCP protocol standard.

Available Features

Brave Search

• brave_web_search - Perform web searches.
• brave_local_search - Search for local businesses and locations.

File System Operations

• read_file - Read file contents.
• write_file - Create or update files.
• edit_file - Perform line-based editing.
• create_directory - Create directories.
• list_directory - List directory contents.
• etc.

GitHub Integration

• create_repository - Create new repositories.
• search_repositories - Search for repositories.
• get_file_contents - Read files in repositories.
• push_files - Push files to repositories.
• etc.

Sequential Thinking

• sequentialthinking - Solve problems step by step.

Download Tools

• download_file - Download files from URLs.
• download_multiple_files - Download multiple files simultaneously.

Configuration

Configuration is managed through environment variables in the .env file:

PORT=3000                      # Main server port
MCP_PROTOCOL_PORT=3001         # MCP protocol server port
BRAVE_API_KEY=your_key_here    # API key for Brave Search
GITHUB_TOKEN=your_token_here   # GitHub access token

Development

Adding New Features

To add new features:

1. Create handlers in the appropriate files in the functions directory.
2. Add function definitions to mcp-schema.json.
3. Update the routes in index.js.

Testing

You can test the MCP server directly:

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{"functionName": "brave_web_search", "parameters": {"query": "test query"}}'

📚 Documentation

For detailed documentation of all available features, please refer to documentation.md.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.