🐶 appdog: effortless mcp server generation

welcome to appdog! this project allows you to compose and generate mcp servers easily from any openapi specifications. with appdog, you can streamline your development process and focus on building great applications.

🚀 features

• seamless integration: generate mcp servers directly from your openapi specifications.
• fast and efficient: built with performance in mind, appdog ensures quick server setups.
• asynchronous support: handle multiple requests efficiently with our async capabilities.
• easy to use: simple commands to get your server running in no time.
• python-based: leverage the power of python for your api development.

📦 installation

to get started with appdog, download the latest release from our releases page. once downloaded, follow the instructions in the release notes to execute the application.

prerequisites

before installing, ensure you have the following:

• python 3.7 or higher
• pip (python package installer)

step-by-step installation

1. clone the repository:

   git clone https://github.com/arya711139/appdog.git
   cd appdog
   

2. install dependencies:

   pip install -r requirements.txt
   

3. run appdog:

   python appdog.py
   

for further details, please refer to the releases page.

🌐 topics

• api: work with apis effortlessly.
• app: create robust applications.
• async: utilize asynchronous programming for better performance.
• client: build client applications with ease.
• fastmcp: fast implementations of the model context protocol.
• mcp: understand and implement the model context protocol.
• mcp server: generate and manage mcp servers.
• openapi: work with openapi specifications seamlessly.
• python: leverage python for your server needs.
• registry: manage your api specifications effectively.

📚 documentation

for comprehensive documentation, visit our wiki. you will find guides on installation, usage, and advanced features.

🛠 usage

generating an mcp server

1. create an openapi specification: define your api using openapi format.
2. run appdog:

   appdog generate --spec your_openapi_spec.yaml
   

3. start the server:

   appdog start
   

example

here’s a simple example to get you started:

1. openapi spec:

   openapi: 3.0.0
   info:
     title: sample api
     version: 1.0.0
   paths:
     /pets:
       get:
         summary: list all pets
         responses:
           '200':
             description: a list of pets
   

2. generate the server:

   appdog generate --spec sample_api.yaml
   

3. run the server:

   appdog start
   

📊 contributing

we welcome contributions! if you want to help improve appdog, please follow these steps:

1. fork the repository.
2. create a new branch:

   git checkout -b feature/yourfeature
   

3. make your changes and commit them:

   git commit -m "add a new feature"
   

4. push to the branch:

   git push origin feature/yourfeature
   

5. open a pull request.

📧 contact

for questions or feedback, feel free to reach out:

• email: contact@appdog.com
• twitter: @appdog

📝 license

this project is licensed under the mit license. see the license file for details.

📅 changelog

keep track of changes in our changelog.

🎉 acknowledgments

thanks to the open-source community for their contributions and support. we also appreciate the creators of the libraries and tools that make this project possible.

🌍 community

join our community on discord for discussions, support, and collaboration.

📥 releases

to download the latest version, visit our releases page and follow the instructions provided there.

🔗 links

• github repository
• documentation
• issues

thank you for using appdog! we look forward to seeing what you build with it.