wehub-resource-sync
63 lines
2.5 KiB
Markdown
63 lines
2.5 KiB
Markdown
# Github MCP Server Example
|
|
|
|
## Description
|
|
|
|
This was a demo created for the AI Agents Hackathon hosted through the Microsoft Reactor.
|
|
|
|
The tools is used to recommend hackathon projects based on a user's Github repos.
|
|
This is done by:
|
|
|
|
1. **Github Agent** - Using the Github MCP Server to retrieve repos and information about those repos.
|
|
2. **Hackathon Agent** - Takes the data from the Github Agent and comes up with creative hackathon project ideas based on the projects, languages used by the user and the project tracks for the AI Agents hackathon.
|
|
3. **Events Agent** - Based on the hackathon agents suggestion, the events agent will recommend relevant events from the AI Agent Hackathon series.
|
|
## Running the code
|
|
|
|
### Environment Variables
|
|
|
|
This demo uses Microsoft Agent Framework, Azure OpenAI Service, the Github MCP Server and Azure AI Search.
|
|
|
|
Make sure that you have the proper environment variables set to use these tools:
|
|
|
|
```python
|
|
AZURE_AI_PROJECT_ENDPOINT=""
|
|
AZURE_AI_MODEL_DEPLOYMENT_NAME=""
|
|
AZURE_SEARCH_SERVICE_ENDPOINT=""
|
|
AZURE_SEARCH_API_KEY=""
|
|
```
|
|
|
|
## Running the Chainlit Server
|
|
|
|
To connect to the MCP server, this demo use Chainlit as a chat interface.
|
|
|
|
To run the server, use the following command in your terminal:
|
|
|
|
```bash
|
|
chainlit run app.py -w
|
|
```
|
|
|
|
This should start your Chainlit server on `localhost:8000` as well as populate your Azure AI Search Index with the `event-descriptions.md` content.
|
|
|
|
## Connecting to the MCP Server
|
|
|
|
To connect to the Github MCP Server, select the "plug" icon underneath the "Type your message here.." chat box:
|
|
|
|
|
|
|
|
From there you can click on the "Connect an MCP" to add the command to connect to the Github MCP Server:
|
|
|
|
```bash
|
|
npx -y @modelcontextprotocol/server-github --env GITHUB_PERSONAL_ACCESS_TOKEN=[YOUR PERSONAL ACCESS TOKEN]
|
|
```
|
|
|
|
Replace "[YOUR PERSONAL ACCESS TOKEN]" with your actual Personal Access Token.
|
|
|
|
After connecting, you should see a (1) next to the plug icon to confirm that its connected. If not, try restarting the chainlit server with `chainlit run app.py -w`.
|
|
|
|
## Using the Demo
|
|
|
|
To start the agent workflow of recommending hackathon projects, you can type a message like:
|
|
|
|
"Recommend hackathon projects for the Github user koreyspace"
|
|
|
|
The Router Agent will analyze your request and determine which combination of agents (GitHub, Hackathon, and Events) is best suited to handle your query. The agents work together to provide comprehensive recommendations based on GitHub repository analysis, project ideation, and relevant tech events.
|