MCP Agents

You can run a lightweight MCP server built with FastMCP to expose simple tools like greeting a user by name. This server lets you connect with MCP clients to invoke tools, test interactions, and iterate on development or demos quickly.

How to use

Start the MCP server locally and connect with a compatible MCP client. You will run the server, then call the available tool(s) such as greet to produce a greeting message. Use the client to pass parameters and view the response in real time. For development or demonstrations, you can run the server from your project workspace and use a client that can discover or reference the server endpoint.

How to install

Prerequisites you need on your machine are a package manager for the runtime environment and a task runner to execute build and run steps.

# Install uv if you don't have it
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install just if you don't have it
# On macOS with Homebrew:
brew install just
# Or with cargo:
cargo install just

Once you have the prerequisites, build the project.

just build

Next, start the MCP agents server.

just run

Configuration, testing, and notes

You can run the server in different modes depending on how you want to deploy or test it.

# Local development (explicit path shown for the example)
{
  "mcpServers": {
    "mcp_agents": {
      "command": "uv",
      "args": ["run", "mcp-agents"]
    }
  }
}

If you publish to a package registry, you can simplify startup with a packaging tool that runs the published package.

{
  "mcpServers": {
    "mcp_agents": {
      "command": "uvx",
      "args": ["amajakai14_mcp-agents"]
    }
  }
}

For end-user installations via a package registry, you may choose an alternative using an isolated runner like pipx.

{
  "mcpServers": {
    "mcp_agents": {
      "command": "pipx",
      "args": ["run", "amajakai14_mcp-agents"]
    }
  }
}

Available tools

greet

Greets a user by name and returns a friendly message.