https://github.com/nicholaswilde/mcp-server

🤖 An MCP server that serves custom AGENTS.md files and bash scripts. 🖥️
https://github.com/nicholaswilde/mcp-server

agents gemini-cli mcp-server

Last synced: 4 months ago
JSON representation

🤖 An MCP server that serves custom AGENTS.md files and bash scripts. 🖥️

• Host: GitHub
• URL: https://github.com/nicholaswilde/mcp-server
• Owner: nicholaswilde
• License: apache-2.0
• Created: 2025-08-30T04:33:54.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2025-09-09T19:59:26.000Z (4 months ago)
• Last Synced: 2025-09-15T10:56:35.757Z (4 months ago)
• Topics: agents, gemini-cli, mcp-server
• Language: Python
• Homepage: http://nicholaswilde.io/mcp-server/
• Size: 758 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          
# :robot: MCP Server :computer:

[![Test Workflow](https://img.shields.io/github/actions/workflow/status/nicholaswilde/mcp-server/test.yml?label=test&style=for-the-badge&branch=main)](https://github.com/nicholaswilde/mcp-server/actions/workflows/test.yml)

[![Task Enabled](https://img.shields.io/badge/Task-Enabled-brightgreen?style=for-the-badge&logo=task&logoColor=white)](https://taskfile.dev/#/)

An MCP (Multi-Cloud Platform) server that provides a library of reusable agent instructions and scripts to a generative AI model.

>[!WARNING]

>This project is in a development stage. Features and configurations are subject to change.

## :book: Documentation

For comprehensive documentation, please visit the [MkDocs site](https://nicholaswilde.io/mcp-server/).

## :mag: TL;DR

The MCP Server uses FastAPI to expose a set of tools that can be consumed by a compatible AI model (like Google's Gemini). It provides a library of standardized instructions (`AGENTS.md` files) and utility scripts (`.sh` files) to enable the AI to perform complex, context-aware tasks.

To bootstrap the project

```bash

task bootstrap

```

To run the server locally:

```bash

task run

```

Add to `gemini-cli` settings:

```json

{

  "mcpServers": {

    "sharedAgents": {

      "httpUrl": "http://:8080"

    }

  }

}

```

## :mag: Overview

This server uses FastAPI to expose a set of tools that can be consumed by a compatible AI model (like Google's Gemini). The primary purpose is to provide the AI with a library of standardized instructions (`AGENTS.md` files) and utility scripts (`.sh` files). This allows the AI to perform complex, context-aware tasks consistently by drawing from a central, version-controlled library.

The core components are:

-   **`app/server.py`**: The FastAPI application that serves the tools.

-   **`agents-library/`**: The central repository for agent instructions and scripts.

## :balance_scale: License

This project is licensed under the [Apache License 2.0](./LICENSE).

## :pencil: Author

This project was started in 2025 by [Nicholas Wilde](https://github.com/nicholaswilde/).