Yoloex/zeta-assistants-mcp-server

Assistants MCP Server

MCP server for integrating and exposing ZMP features and capabilities using assistants-tools.

Quick Start

Install Dependencies

curl -LsSf https://astral.sh/uv/install.sh | sh
uv sync --all-extras

Setup Environment

cp .env.example .env
source .env

Optional: Install assistants-mcp for Development

If you need to work with the assistants-mcp library in development mode:

# Navigate to the assistants-mcp directory
cd ../assistants-mcp

# Install assistants-mcp in development mode
uv pip install -e .

# Return to the assistants-mcp-server directory
cd ../assistants-mcp-server

This will install the assistants-mcp library in editable mode, allowing you to make changes to the library code and see them reflected immediately without reinstalling.

Run Server

cd docker
docker compose up zh-assistants-mcp-server

Server available at http://localhost:9191

Running Unit Tests

# set the required environment variables in your terminal.
cd docker
docker compose -f docker-compose-common.yml build zh-assistants-mcp-server-base && docker compose -f docker-compose-tests.yml up --build --exit-code-from zh-assistants-mcp-server-unit-tests zh-assistants-mcp-server-unit-tests

Server available at http://localhost:9191

[Optional] Authentication

By default, authentication is disabled. Use the mcp_client_access_token.sh script to generate access tokens for MCP Inspector.

Development

Adding New Tools

To add new MCP tools to this server, see the dedicated guide:

This guide covers:

• Tool implementation methods (functions, decorators, classes)
• Code organization and best practices
• Unit testing strategies
• Testing with MCP Inspector
• Troubleshooting common issues

MCP Inspector

MCP Inspector is a developer tool for testing and debugging MCP servers.

Refer to README under mcp-inspector