slattman/contextum-evm-mcp-server

Contextum EVM MCP Server

This is the Contextum EVM Model Context Protocol (MCP) server built with Bun and TypeScript.

Development

Run the server locally:

bun run dev

The server runs on http://localhost:8787.

Visit http://localhost:8787/context to test the server response.

Installation

1. Clone the repository:

git clone https://github.com/ContextumAI/contextum-evm-mcp-server.git
cd contextum-evm-mcp-server

2. Install dependencies using Bun:

bun install

or using npm:

npm install

Configuration

• Default server port is 8787.

• To change it, edit src/server/http-server.ts and update the port number.

• Supported chains and their RPC URLs are defined in src/core/chains.ts.

Usage

Run server in development mode (auto reload on code changes):

bun run dev

Run server in production mode:

bun start

Testing

Open your browser or use curl to test:

curl http://localhost:8787/context

Contributing to Contextum

Thank you for your interest in contributing to Contextum! 🚀

We welcome help with:

• Bug fixes
• Feature proposals
• Protocol improvements
• Documentation
• Smart contract review

🛠 How to Contribute

1. Fork the repo
2. Clone to your local machine
3. Create a new branch: git checkout -b my-feature
4. Make your changes
5. Commit and push: git push origin my-feature
6. Create a Pull Request

Communication

• Open an issue for discussions or proposals
• Join the conversation (coming soon: Discord/Telegram)
• Email: founders@contextum.org

Code Style

• TypeScript: follow standard formatting
• Commit messages: use Conventional Commits
• Smart contracts: comment everything; assume others will read it

Security

If you discover a vulnerability, please email us directly at founders@contextum.org — do not file a public issue.

Thank you for helping build the decentralized AI infrastructure of the future.

License

This project is licensed under the MIT License.