GitHub Remote MCP Server

🧠 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:

• MCP Inspector UI at: http://localhost:6274
• SSE endpoint at: http://localhost:6277/sse

✅ Test Agent via CLI

✅ Or Use Chat UI

Lab 2: Use GitHub’s New Remote MCP Server (Public Preview)

🆕 As of June 12, 2025, you can register and use remote tools on GitHub’s cloud MCP platform.

🛠 Steps

1. Install latest mcp CLI:

2. Register your tool with GitHub’s MCP cloud server:

3. Start agent with remote tools:

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:

Then launch it:

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:

Run it with:

Then connect your agent to:

Now you can access both tools from one endpoint!