Dog MCP Server 🐶

This is a simple MCP server built with FastMCP that connects to Goose and fetches random dog images using the Dog API. MCP--UI support has been added

You'll build this project step-by-step in the workshop!

---

🛠 Prerequisites

• Node.js 22.x (recommended via nvm)
• npm
• Goose Desktop
• (Recommended) nvm (Node Version Manager) — makes using the .nvmrc easy

---

🚀 Setup

Clone the project and install dependencies:

git clone https://github.com/EbonyLouis/fastmcp-boilerplate.git dog-mcp
cd dog-mcp
nvm use --install   # make sure you DO this step
npm install

If you see the error command not found: nvm, install Node manually or install nvm first, then rerun nvm use --install

---

🧪 Run it with Goose

After any changes build the project, & connect it to Goose using:

npm run build

Then in Goose Desktop, add the extension with:

node /Users/[userdirectory]/dog-mcp/dist/server.js

This connects your local server to Goose using the compiled version.

---

🧑‍💻 During the Workshop

You’ll build and connect the server live by:

1. Writing a tool that fetches a random dog image
2. Connecting it to Goose
3. Prompting Goose to try it out
4. Adding a second tool to fetch dogs by breed

The server.ts file starts simple and will be updated live.

---

🧼 Scripts

• Build the project (required after each code change if you're using node dist/server.js):

npm run build

---

👀 Want to explore more?

Check out:

• Dog API docs
• FastMCP GitHub
• Goose Open Source Agent

---

🐾 Built with love and dog pics.