Skip to content

Commit 6a772e2

Browse files
authored
Merge branch 'main' into foxy-contexts
2 parents c9e5036 + ea35591 commit 6a772e2

File tree

6 files changed

+131
-14
lines changed

6 files changed

+131
-14
lines changed

README.md

Lines changed: 17 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,9 @@ Official integrations are maintained by companies building production ready MCP
4343
- **[Obsidian Markdown Notes](https://github.com/calclavia/mcp-obsidian)** - Read and search through your Obsidian vault or any directory containing Markdown notes
4444
- <img height="12" width="12" src="https://e2b.dev/favicon.ico" alt="E2B Logo" /> **[E2B](https://github.com/e2b-dev/mcp-server)** - Run code in secure sandboxes hosted by [E2B](https://e2b.dev)
4545
- <img height="12" width="12" src="https://exa.ai/images/favicon-32x32.png" alt="Exa Logo" /> **[Exa](https://github.com/exa-labs/exa-mcp-server)** - Search Engine made for AIs by [Exa](https://exa.ai)
46+
- <img height="12" width="12" src="https://cdn.simpleicons.org/jetbrains" /> **[JetBrains](https://github.com/JetBrains/mcp-jetbrains)** – Work on your code with JetBrains IDEs
4647
- **[Neon](https://github.com/neondatabase/mcp-server-neon)** - Interact with the Neon serverless Postgres platform
48+
- <img height="12" width="12" src="https://neo4j.com/favicon.ico" alt="Neo4j Logo" /> **[Neo4j](https://github.com/neo4j-contrib/mcp-neo4j/)** - Neo4j graph database server (schema + read/write-cypher) and separate graph database backed memory
4749
- <img height="12" width="12" src="https://www.tinybird.co/favicon.ico" alt="Tinybird Logo" /> **[Tinybird](https://github.com/tinybirdco/mcp-tinybird)** - Interact with Tinybird serverless ClickHouse platform
4850
- <img height="12" width="12" src="https://pics.fatwang2.com/56912e614b35093426c515860f9f2234.svg" /> [Search1API](https://github.com/fatwang2/search1api-mcp) - One API for Search, Crawling, and Sitemaps
4951
- <img height="12" width="12" src="https://qdrant.tech/img/brand-resources-logos/logomark.svg" /> **[Qdrant](https://github.com/qdrant/mcp-server-qdrant/)** - Implement semantic memory layer on top of the Qdrant vector search engine
@@ -60,7 +62,7 @@ A growing set of community-developed and maintained servers demonstrates various
6062
- **[Spotify](https://github.com/varunneal/spotify-mcp)** - This MCP allows an LLM to play and use Spotify.
6163
- **[Inoyu](https://github.com/sergehuber/inoyu-mcp-unomi-server)** - Interact with an Apache Unomi CDP customer data platform to retrieve and update customer profiles
6264
- **[Vega-Lite](https://github.com/isaacwasserman/mcp-vegalite-server)** - Generate visualizations from fetched data using the VegaLite format and renderer.
63-
- **[Snowflake](https://github.com/datawiz168/mcp-snowflake-service)** - This MCP server enables LLMs to interact with Snowflake databases, allowing for secure and controlled data operations.
65+
- **[Snowflake](https://github.com/isaacwasserman/mcp-snowflake-server)** - This MCP server enables LLMs to interact with Snowflake databases, allowing for secure and controlled data operations.
6466
- **[MySQL](https://github.com/designcomputer/mysql_mcp_server)** (by DesignComputer) - MySQL database integration in Python with configurable access controls and schema inspection
6567
- **[MySQL](https://github.com/benborla/mcp-server-mysql)** (by benborla) - MySQL database integration in NodeJS with configurable access controls and schema inspection
6668
- **[MSSQL](https://github.com/aekanun2020/mcp-server/)** - MSSQL database integration with configurable access controls and schema inspection
@@ -80,15 +82,28 @@ A growing set of community-developed and maintained servers demonstrates various
8082
- **[Docker](https://github.com/ckreiling/mcp-server-docker)** - Integrate with Docker to manage containers, images, volumes, and networks.
8183
- **[Kubernetes](https://github.com/Flux159/mcp-server-kubernetes)** - Connect to Kubernetes cluster and manage pods, deployments, and services.
8284
- **[OpenAPI](https://github.com/snaggle-ai/openapi-mcp-server)** - Interact with [OpenAPI](https://www.openapis.org/) APIs.
83-
- **[Pandoc](https://github.com/vivekVells/mcp-pandoc)** - MCP server for seamless document format conversion using Pandoc, supporting Markdown, HTML, and plain text, with other formats like PDF, csv and docx in development.
85+
- **[Pandoc](https://github.com/vivekVells/mcp-pandoc)** - MCP server for seamless document format conversion using Pandoc, supporting Markdown, HTML, and plain text, with other formats like PDF, csv and docx in development.
86+
- **[Pinecone](https://github.com/sirmews/mcp-pinecone)** - MCP server for searching and uploading records to Pinecone. Allows for simple RAG features, leveraging Pinecone's Inference API.
8487
- **[HuggingFace Spaces](https://github.com/evalstate/mcp-hfspace)** - Server for using HuggingFace Spaces, supporting Open Source Image, Audio, Text Models and more. Claude Desktop mode for easy integration.
8588
- **[ChatSum](https://github.com/chatmcp/mcp-server-chatsum)** - Query and Summarize chat messages with LLM. by [mcpso](https://mcp.so)
8689
- **[Rememberizer AI](https://github.com/skydeckai/mcp-server-rememberizer)** - An MCP server designed for interacting with the Rememberizer data source, facilitating enhanced knowledge retrieval.
90+
- **[FlightRadar24](https://github.com/sunsetcoder/flightradar24-mcp-server)** - A Claude Desktop MCP server that helps you track flights in real-time using Flightradar24 data.
8791
- **[X (Twitter)](https://github.com/vidhupv/x-mcp)** (by vidhupv) - Create, manage and publish X/Twitter posts directly through Claude chat.
8892
- **[X (Twitter)](https://github.com/EnesCinr/twitter-mcp)** (by EnesCinr) - Interact with twitter API. Post tweets and search for tweets by query.
8993
- **[RAG Web Browser](https://github.com/apify/mcp-server-rag-web-browser)** An MCP server for Apify's RAG Web Browser Actor to perform web searches, scrape URLs, and return content in Markdown.
9094
- **[XMind](https://github.com/apeyroux/mcp-xmind)** - Read and search through your XMind directory containing XMind files.
9195
- **[oatpp-mcp](https://github.com/oatpp/oatpp-mcp)** - C++ MCP integration for Oat++. Use [Oat++](https://oatpp.io) to build MCP servers.
96+
- **[Contentful-mcp](https://github.com/ivo-toby/contentful-mcp)** - Read, update, delete, publish content in your [Contentful](https://contentful.com) space(s) from this MCP Server.
97+
- **[Home Assistant](https://github.com/tevonsb/homeassistant-mcp)** - Interact with [Home Assistant](https://www.home-assistant.io/) including viewing and controlling lights, switches, sensors, and all other Home Assistant entities.
98+
- **[cognee-mcp](https://github.com/topoteretes/cognee-mcp-server)** - GraphRAG memory server with customizable ingestion, data processing and search
99+
- **[Airtable](https://github.com/domdomegg/airtable-mcp-server)** - Read and write access to [Airtable](https://airtable.com/) databases, with schema inspection.
100+
- **[mcp-k8s-go](https://github.com/strowk/mcp-k8s-go)** - Golang-based Kubernetes server for MCP to browse pods and their logs, events, namespaces and more. Built to be extensible.
101+
- **[Notion](https://github.com/v-3/notion-server)** (by v-3) - Notion MCP integration. Search, Read, Update, and Create pages through Claude chat.
102+
- **[Notion](https://github.com/suekou/mcp-notion-server)** (by suekou) - Interact with Notion API.
103+
- **[TMDB](https://github.com/Laksh-star/mcp-server-tmdb)** - This MCP server integrates with The Movie Database (TMDB) API to provide movie information, search capabilities, and recommendations.
104+
- **[MongoDB](https://github.com/kiliczsh/mcp-mongo-server)** - A Model Context Protocol Server for MongoDB.
105+
- **[Airtable](https://github.com/felores/airtable-mcp)** - Airtable Model Context Protocol Server.
106+
- **[Fetch](https://github.com/zcaceres/fetch-mcp)** - A server that flexibly fetches HTML, JSON, Markdown, or plaintext
92107

93108
## 📚 Resources
94109

src/everything/README.md

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Everything MCP Server
1+
# Everything MCP Server
22

33
This MCP server attempts to exercise all the features of the MCP protocol. It is not intended to be a useful server, but rather a test server for builders of MCP clients. It implements prompts, tools, resources, sampling, and more to showcase MCP capabilities.
44

@@ -15,7 +15,7 @@ This MCP server attempts to exercise all the features of the MCP protocol. It is
1515
2. `add`
1616
- Adds two numbers together
1717
- Inputs:
18-
- `a` (number): First number
18+
- `a` (number): First number
1919
- `b` (number): Second number
2020
- Returns: Text result of the addition
2121

@@ -27,7 +27,7 @@ This MCP server attempts to exercise all the features of the MCP protocol. It is
2727
- Returns: Completion message with duration and steps
2828
- Sends progress notifications during execution
2929

30-
4. `sampleLLM`
30+
4. `sampleLLM`
3131
- Demonstrates LLM sampling capability using MCP sampling feature
3232
- Inputs:
3333
- `prompt` (string): The prompt to send to the LLM
@@ -39,17 +39,23 @@ This MCP server attempts to exercise all the features of the MCP protocol. It is
3939
- No inputs required
4040
- Returns: Base64 encoded PNG image data
4141

42+
6. `printEnv`
43+
- Prints all environment variables
44+
- Useful for debugging MCP server configuration
45+
- No inputs required
46+
- Returns: JSON string of all environment variables
47+
4248
### Resources
4349

4450
The server provides 100 test resources in two formats:
45-
- Even numbered resources:
51+
- Even numbered resources:
4652
- Plaintext format
4753
- URI pattern: `test://static/resource/{even_number}`
4854
- Content: Simple text description
4955

5056
- Odd numbered resources:
5157
- Binary blob format
52-
- URI pattern: `test://static/resource/{odd_number}`
58+
- URI pattern: `test://static/resource/{odd_number}`
5359
- Content: Base64 encoded binary data
5460

5561
Resource features:

src/everything/everything.ts

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
22
import {
33
CallToolRequestSchema,
4+
CompleteRequestSchema,
45
CreateMessageRequest,
56
CreateMessageResultSchema,
67
GetPromptRequestSchema,
@@ -40,6 +41,8 @@ const LongRunningOperationSchema = z.object({
4041
steps: z.number().default(5).describe("Number of steps in the operation"),
4142
});
4243

44+
const PrintEnvSchema = z.object({});
45+
4346
const SampleLLMSchema = z.object({
4447
prompt: z.string().describe("The prompt to send to the LLM"),
4548
maxTokens: z
@@ -48,12 +51,20 @@ const SampleLLMSchema = z.object({
4851
.describe("Maximum number of tokens to generate"),
4952
});
5053

54+
// Example completion values
55+
const EXAMPLE_COMPLETIONS = {
56+
style: ["casual", "formal", "technical", "friendly"],
57+
temperature: ["0", "0.5", "0.7", "1.0"],
58+
resourceId: ["1", "2", "3", "4", "5"],
59+
};
60+
5161
const GetTinyImageSchema = z.object({});
5262

5363
enum ToolName {
5464
ECHO = "echo",
5565
ADD = "add",
5666
LONG_RUNNING_OPERATION = "longRunningOperation",
67+
PRINT_ENV = "printEnv",
5768
SAMPLE_LLM = "sampleLLM",
5869
GET_TINY_IMAGE = "getTinyImage",
5970
}
@@ -297,6 +308,11 @@ export const createServer = () => {
297308
description: "Adds two numbers",
298309
inputSchema: zodToJsonSchema(AddSchema) as ToolInput,
299310
},
311+
{
312+
name: ToolName.PRINT_ENV,
313+
description: "Prints all environment variables, helpful for debugging MCP server configuration",
314+
inputSchema: zodToJsonSchema(PrintEnvSchema) as ToolInput,
315+
},
300316
{
301317
name: ToolName.LONG_RUNNING_OPERATION,
302318
description:
@@ -374,6 +390,17 @@ export const createServer = () => {
374390
};
375391
}
376392

393+
if (name === ToolName.PRINT_ENV) {
394+
return {
395+
content: [
396+
{
397+
type: "text",
398+
text: JSON.stringify(process.env, null, 2),
399+
},
400+
],
401+
};
402+
}
403+
377404
if (name === ToolName.SAMPLE_LLM) {
378405
const validatedArgs = SampleLLMSchema.parse(args);
379406
const { prompt, maxTokens } = validatedArgs;
@@ -412,6 +439,34 @@ export const createServer = () => {
412439
throw new Error(`Unknown tool: ${name}`);
413440
});
414441

442+
server.setRequestHandler(CompleteRequestSchema, async (request) => {
443+
const { ref, argument } = request.params;
444+
445+
if (ref.type === "ref/resource") {
446+
const resourceId = ref.uri.split("/").pop();
447+
if (!resourceId) return { completion: { values: [] } };
448+
449+
// Filter resource IDs that start with the input value
450+
const values = EXAMPLE_COMPLETIONS.resourceId.filter(id =>
451+
id.startsWith(argument.value)
452+
);
453+
return { completion: { values, hasMore: false, total: values.length } };
454+
}
455+
456+
if (ref.type === "ref/prompt") {
457+
// Handle completion for prompt arguments
458+
const completions = EXAMPLE_COMPLETIONS[argument.name as keyof typeof EXAMPLE_COMPLETIONS];
459+
if (!completions) return { completion: { values: [] } };
460+
461+
const values = completions.filter(value =>
462+
value.startsWith(argument.value)
463+
);
464+
return { completion: { values, hasMore: false, total: values.length } };
465+
}
466+
467+
throw new Error(`Unknown reference type`);
468+
});
469+
415470
server.setRequestHandler(SetLevelRequestSchema, async (request) => {
416471
const { level } = request.params;
417472

src/git/README.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -73,6 +73,12 @@ Please note that mcp-server-git is currently in early development. The functiona
7373
- `repo_path` (string): Path to Git repository
7474
- `branch_name` (string): Name of branch to checkout
7575
- Returns: Confirmation of branch switch
76+
9. `git_show`
77+
- Shows the contents of a commit
78+
- Inputs:
79+
- `repo_path` (string): Path to Git repository
80+
- `revision` (string): The revision (commit hash, branch name, tag) to show
81+
- Returns: Contents of the specified commit
7682

7783
## Installation
7884

src/git/src/mcp_server_git/server.py

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,10 @@ class GitCheckout(BaseModel):
5252
repo_path: str
5353
branch_name: str
5454

55+
class GitShow(BaseModel):
56+
repo_path: str
57+
revision: str
58+
5559
class GitTools(str, Enum):
5660
STATUS = "git_status"
5761
DIFF_UNSTAGED = "git_diff_unstaged"
@@ -63,6 +67,7 @@ class GitTools(str, Enum):
6367
LOG = "git_log"
6468
CREATE_BRANCH = "git_create_branch"
6569
CHECKOUT = "git_checkout"
70+
SHOW = "git_show"
6671

6772
def git_status(repo: git.Repo) -> str:
6873
return repo.git.status()
@@ -113,6 +118,24 @@ def git_checkout(repo: git.Repo, branch_name: str) -> str:
113118
repo.git.checkout(branch_name)
114119
return f"Switched to branch '{branch_name}'"
115120

121+
def git_show(repo: git.Repo, revision: str) -> str:
122+
commit = repo.commit(revision)
123+
output = [
124+
f"Commit: {commit.hexsha}\n"
125+
f"Author: {commit.author}\n"
126+
f"Date: {commit.authored_datetime}\n"
127+
f"Message: {commit.message}\n"
128+
]
129+
if commit.parents:
130+
parent = commit.parents[0]
131+
diff = parent.diff(commit, create_patch=True)
132+
else:
133+
diff = commit.diff(git.NULL_TREE, create_patch=True)
134+
for d in diff:
135+
output.append(f"\n--- {d.a_path}\n+++ {d.b_path}\n")
136+
output.append(d.diff.decode('utf-8'))
137+
return "".join(output)
138+
116139
async def serve(repository: Path | None) -> None:
117140
logger = logging.getLogger(__name__)
118141

@@ -179,6 +202,11 @@ async def list_tools() -> list[Tool]:
179202
description="Switches branches",
180203
inputSchema=GitCheckout.schema(),
181204
),
205+
Tool(
206+
name=GitTools.SHOW,
207+
description="Shows the contents of a commit",
208+
inputSchema=GitShow.schema(),
209+
)
182210
]
183211

184212
async def list_repos() -> Sequence[str]:
@@ -290,6 +318,13 @@ async def call_tool(name: str, arguments: dict) -> list[TextContent]:
290318
text=result
291319
)]
292320

321+
case GitTools.SHOW:
322+
result = git_show(repo, arguments["revision"])
323+
return [TextContent(
324+
type="text",
325+
text=result
326+
)]
327+
293328
case _:
294329
raise ValueError(f"Unknown tool: {name}")
295330

src/google-maps/README.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,45 +4,45 @@ MCP Server for the Google Maps API.
44

55
## Tools
66

7-
1. `geocode`
7+
1. `maps_geocode`
88
- Convert address to coordinates
99
- Input: `address` (string)
1010
- Returns: location, formatted_address, place_id
1111

12-
2. `reverse_geocode`
12+
2. `maps_reverse_geocode`
1313
- Convert coordinates to address
1414
- Inputs:
1515
- `latitude` (number)
1616
- `longitude` (number)
1717
- Returns: formatted_address, place_id, address_components
1818

19-
3. `search_places`
19+
3. `maps_search_places`
2020
- Search for places using text query
2121
- Inputs:
2222
- `query` (string)
2323
- `location` (optional): { latitude: number, longitude: number }
2424
- `radius` (optional): number (meters, max 50000)
2525
- Returns: array of places with names, addresses, locations
2626

27-
4. `get_place_details`
27+
4. `maps_place_details`
2828
- Get detailed information about a place
2929
- Input: `place_id` (string)
3030
- Returns: name, address, contact info, ratings, reviews, opening hours
3131

32-
5. `get_distance_matrix`
32+
5. `maps_distance_matrix`
3333
- Calculate distances and times between points
3434
- Inputs:
3535
- `origins` (string[])
3636
- `destinations` (string[])
3737
- `mode` (optional): "driving" | "walking" | "bicycling" | "transit"
3838
- Returns: distances and durations matrix
3939

40-
6. `get_elevation`
40+
6. `maps_elevation`
4141
- Get elevation data for locations
4242
- Input: `locations` (array of {latitude, longitude})
4343
- Returns: elevation data for each point
4444

45-
7. `get_directions`
45+
7. `maps_directions`
4646
- Get directions between points
4747
- Inputs:
4848
- `origin` (string)

0 commit comments

Comments
 (0)