Adding cody mcp

[arafatkatze]

Related OpenContext PR

Purposely waiting to do the final steps of the PR AFTER the base merge conflicts from Bee's PR is resolved and a demo is shared and discussed properly.

Test plan

Example MCP server implementation

1. for Echo Tool
   https://www.loom.com/share/6c605cb1ccd4479ea269743ae6dd3529

• Pull the MCP server from this specific branch https://github.com/arafatkatze/servers/tree/mcp-server-ara
• cd src/everything/
• npm run build
• You would also have to run pnpm openctx:link to be able to link the local OpenCTX latest repo
• node dist/test_mcp.js If this works fine for you that means the local MCP is running

Now run the branch in the debugger and set the settings in vscode as

  "openctx.providers": {
    "mcp": {
      "enabled": true, 
      "uri": "file:///path_to_servers/src/everything/dist/index.js",
      "toolNameQuery": "echo"
    }
  },

Please make sure to have three slashes /// in the uri after file.
For this example the toolnamequery is echo.

3. for Postgres tool

• Pull the MCP server https://github.com/arafatkatze/servers/
• cd src/postgres/
• npm run build
• You would also have to run pnpm openctx:link to be able to link the local OpenCTX latest repo

Now run the branch in the debugger and set the settings in vscode as

  "openctx.providers": {
    "mcp": {
      "enabled": true, 
      "uri": "file:///Users/arafatkhan/Desktop/servers/src/postgres/dist/index.js",
      "toolNameQuery": "query",
      "args": ["postgresql://postgres:postgres@localhost:5433/postgres"]
    }
  },

Please make sure to have three slashes /// in the uri after file.
For this example the toolnamequery is query(that's defined in the MCP)

Now in deep cody ask the question:

from the local run of the postgres tool tell me the name of the users from the users table

NOTE: You gotta run the MCP with docker locally and make sure that postgres works properly for you before you do this.

For me I had

➜  postgres git:(mcp-server-ara) ✗ psql -h localhost -p 5433 -U postgres -d postgres
psql (16.6 (Homebrew), server 17.2 (Debian 17.2-1.pgdg120+1))
WARNING: psql major version 16, server major version 17.
         Some psql features might not work.
Type "help" for help.

postgres=# list
postgres-# ;
ERROR:  syntax error at or near "list"
LINE 1: list
        ^
postgres=# CREATE TABLE users (
    id SERIAL PRIMARY KEY,
    username VARCHAR(50) NOT NULL,
    email VARCHAR(255) NOT NULL UNIQUE,
    created_at TIMESTAMP WITH TIME ZONE DEFAULT CURRENT_TIMESTAMP
);
CREATE TABLE
postgres=# INSERT INTO users (username, email) VALUES 
    ('john_doe', '[email protected]'),
    ('jane_smith', '[email protected]');
INSERT 0 2
postgres=# \l           -- List all databases
\dt          -- List all tables
\d users     -- Describe the users table structure
\x           -- Toggle expanded display for better readability
SELECT * FROM users;  -- View table contents
ERROR:  column d.daticulocale does not exist
LINE 8:   d.daticulocale as "ICU Locale",
          ^
HINT:  Perhaps you meant to reference the column "d.datlocale".
postgres=# SELECT * FROM users;
 id |  username  |      email       |          created_at           
----+------------+------------------+-------------------------------
  1 | john_doe   | [email protected] | 2025-01-16 23:48:11.031239+00
  2 | jane_smith | [email protected] | 2025-01-16 23:48:11.031239+00
(2 rows)

postgres=# exit
➜  postgres git:(mcp-server-ara) ✗ 

https://www.loom.com/share/a933fef57b6c42b5b5e06eced9e91c9f

[abeatrix]

I just noticed you are on an old branch so probably unaware of the changes we have on main where we automatically build the tool from openCtx providers via setupOpenCtxProviderListener. In that method we can get the mentions from the MCP and convert them using openCtxProviderMetadata so that we can create the tools for all openCtx providers using the same createOpenCtxTools method.

Let me know if this is confusing or if you have any concerns about this approach!

[abeatrix]

Suggested change

	public parse(): string[] {
	try {
	JSON.parse(this.unprocessedText)
	} catch {
	return []
	}
	const unparsedText = this.unprocessedText
	this.reset()
	return [unparsedText]
	}

As discussed, this is for parsing the sub XML tag where the queries are returned by the LLM through stream. we can move this into execute instead

[github-actions]

‼️ Hey @sourcegraph/cody-security, please review this PR carefully as it introduces the usage of an unsafe_ function or abuses PromptString.

[abeatrix]

this should be done in getViewerSettingsProviders below

[abeatrix]

nit: it would be cool if we can get the mcpProviders in one call, instead needing to call the proxy and generate the providers on the client side

[abeatrix]

Suggested change

"default": {},

Do we need an empty default?

[abeatrix]

Suggested change

	"markdownDescription": "Regex for the MCP provider tools in OpenCtx.",
	"markdownDescription": "Regex for the MCP provider tools in OpenCtx.",
	"example": "?"

Would be cool if we can provide an example on how this should be used

[abeatrix]

Suggested change

	uri: '',
	uri: '',

We need to create a uri or the context item name will be empty showing in the context list

[abeatrix]

Suggested change

	if (defaultConfig) {
	return defaultConfig[1]
	}
	return {
	title: provider.title,
	return (
	defaultConfig?.[1] ?? {
	title: provider.title,