Mcpscope

A simple local MCP (Model Context Protocol) server built with fastmcp.

Tools

Requirements

• Python 3.12+
• uv

Setup

# Clone the repository
git clone https://github.com/sla10132000/mcpscope.git
cd mcpscope

# Install dependencies
uv sync

Running the server

uv run python server.py

Using with Claude Code

Add the following to your .mcp.json:

{
  "mcpServers": {
    "mcpscope": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/path/to/mcpscope"
    }
  }
}

Replace /path/to/mcpscope with the actual path to your clone.

Adding new tools

Open server.py and add a decorated function:

@mcp.tool()
def your_tool(param: str) -> str:
    """ツールの説明"""
    return f"result: {param}"

fastmcp automatically exposes it as an MCP tool — no further registration needed.