Skip to main content
Glama

GitHub Remote MCP Server

by brentlaster
README.md2.81 kB
[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/brentlaster/agent-mcp-ollama?quickstart=1) # 🧠 Agent with MCP Tools and Ollama (Codespaces Ready) This project demonstrates how to use `smolagents`, `mcp`, and `Ollama` in GitHub Codespaces, and how to integrate with GitHub's **remote MCP server (public preview)**. --- ## Lab 1: Use Local MCP Inspector in Codespaces ### ✅ Setup 1. Open this repo in **GitHub Codespaces** 2. Ensure `.devcontainer` builds the container with `Ollama` and Python dependencies 3. In terminal: ```bash pip install mcp mcp dev calculator.py ``` - MCP Inspector UI at: `http://localhost:6274` - SSE endpoint at: `http://localhost:6277/sse` ### ✅ Test Agent via CLI ```bash python test_calculator_agent.py ``` ### ✅ Or Use Chat UI ```bash python chat_calculator_agent.py ``` --- ## Lab 2: Use GitHub’s New Remote MCP Server (Public Preview) 🆕 As of [June 12, 2025](https://github.blog/changelog/2025-06-12-remote-github-mcp-server-is-now-available-in-public-preview/), you can register and use remote tools on GitHub’s cloud MCP platform. ### 🛠 Steps 1. Install latest `mcp` CLI: ```bash pip install --upgrade mcp ``` 2. Register your tool with GitHub’s MCP cloud server: ```bash mcp register --tool calculator.py --remote ``` 3. Start agent with remote tools: ```python mcp_client = MCPClient({ "url": "https://mcp.github.dev/sse", "token": "<your GitHub token>" }) ``` 4. Run the CLI agent or Gradio app as usual --- ### 🔁 Lab 3: Add a Second Tool (Reverse String) This lab shows how to add another tool to the MCP Inspector workflow. #### ✅ Setup Create `reverse_string.py`: ```python from mcp import tool @tool def reverse_string(text: str) -> str: return text[::-1] ``` Then launch it: ```bash mcp dev reverse_string.py ``` Update your test agent or Gradio interface to prompt: > "Reverse the string 'hello world'" 🧠 The LLM will choose the appropriate tool via schema-based reasoning. --- ## 🎁 Bonus: Multi-Tool MCP Server Instead of running individual tools, you can host multiple tools in a single server using FastMCP. ### ✅ Setup Create a file `multi_tool_server.py`: ```python from fastapi import FastAPI from fastmcp import FastMCP from mcp import tool @tool def calculator(expression: str) -> str: try: result = eval(expression, {"__builtins__": {}}) return str(result) except Exception as e: return f"Error: {str(e)}" @tool def reverse_string(text: str) -> str: return text[::-1] app = FastMCP().app ``` Run it with: ```bash python multi_tool_server.py ``` Then connect your agent to: ```python MCPClient({"url": "http://127.0.0.1:7860/sse"}) ``` Now you can access **both tools** from one endpoint!

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/brentlaster/agent-mcp-ollama'

If you have feedback or need assistance with the MCP directory API, please join our Discord server